Arduino ESP8266 创建OneNet设备（二）

用户注册

用户注册和产品创建我们在OneNET平台上开展产品开发的前提。为了使用OneNET设备云的强大功能，首要做的是在OneNET上注册您的开发者账号，来创建您专属的“开发者中心”；
点击首页右上角的“注册”按钮，注册用户账号；

填写用户名、用户密码、有效手机号码，点击获取验证码，查看短信验证码，并完成注册；

注册完成后，自动回到主页，通过右上角入口登录，登录后进入到我们的“开发者中心”。

产品创建

接下来，为了使用OneNET的功能和服务，需要在OneNET平台上创建您的产品；
点击右上角的 “创建产品”，在弹出页面中按照提示填写产品的基本信息，进行产品创建；按照提示尽可能完整、全面地填写相应内容，这样更方便后期对产品进行管理；

其中最重要的信息为“设备接入协议”，在协议选择的右侧有各协议的基本功能介绍，若需要详细了解各接入协议，可前往开发者中心的硬件接入板块中了解。在这里我选择的是HTTP协议

关于具体如何通过上述这些协议进行硬件接入和应用开发，详细资料可参见 “开发者中心”的“硬件接入”和“应用开发”板块。
产品创建完成之后，进入的“产品列表”页面，点击列表中的产品就可以开发产品了：

通信准备

首先，我们需要建立属于自己的设备数据流，如下所示：

数据流建立好了，摘出通信所需的数据信息：设备ID、设备名称、Master-APIkey等，

在这里我传输的数据主要有：温湿度、烟雾、光照、。

传输格式如下所示：

POST http://api.heclouds.com/devices/500259133/datapoints?type=3 HTTP/1.1
api-key: sWydCX=jX3RfgT3bYxaorgEbZ9o=
Host:api.heclouds.com
Connection:close
Content-Length:69

{"TEM":22,"HUM":52,"TEM2":27,"HUM2":60,"SMO":427,"SMO2":460,"LIG":40}

界面查看：

https://open.iot.10086.cn/iotbox/appsquare/appview?openid=5ca523334a5a9b576e316a586de6d738

OneNet知识补充

主要运用的是HTTP协议，onenet平台还支持其他三种协议，这里就不一一说了，调试的方法类似，适合不同习惯不同运用场合下。

1 回话方式：HTTP/1.0。HTTP/1.1HTTP-NG。这里只用到了HTTP/1.0和HTTP/1.1。另外一种不清楚。HTTP/1.0
HTTP/1.0
1.1 建立连接->请求->响应->断开连接每次连接只处理一次请求和相应，对资源的每一次访问都要建立一个单独的连接。浏览器到服务器的每次通讯都是完全分开的。没有Host域，所以不可以创建基于主机头的虚拟主机
HTTP/1.1
1.2 在一个TCP连接中可以传送多个HTTP请求和响应不需要等待上次HTTP响应完毕，可以多个HTTP请求同时进行。服务器会根据浏览器发送的请求顺序来按顺序进行响应，这被称作管线。有Host域，可以建立虚拟主机。

2. 请求消息
   结构：
   请求行
   若干消息头(可选)

实体内容(可选)
GET无实体内容

3请求方式：
GET：请求获取Request-URI所标识的资源

POST：在Request-URI所标识的的资源后附加新的数据

HEAD：请求获取Request-URI所标识的资源的响应消息报头

PUT：请求服务器存储一个资源，并用Request-URI作为资源标识

DELETE：请求服务器删除Request-URI所标识的资源

TRACE：请求服务器回送收到的请求信息，主要用于测试和诊断

CONNECT：保留将来使用

OPTIONS：请求查询服务器的性能，或者查询与资源相关的选项和需求

ps:一般物联网平台用的比较多的是post和get方法，其他方法很少见。

4. 状态行
   结构：HTTP版本号_状态码_状态描述(CRLF)如：HTTP/1.1 200 OK

5. 使用GET和POST传递参数
   GET使用URL传递参数
   如：
   GET /List.aspx?Catagoryid=5&Cityid=23 HTTP/1.1
   POST使用实体内容传递参数
   如：
   POST /List.aspx HTTP/1.1
   Content-Type:application/x-www-form-urlencoded
   Content-Length:22

Catagoryid=5&Cityid=23
在POST消息头中要设置Content-Type的值为application/x-www-form-urlencoded，以及使用Content-Length 以标识实体内容的长度。
当Content-Length长度比实体内容长度短时，则会忽略多出部分的实体内容。当Content-Length少于实体长度时，则会继续等待。

6 响应状态码
状态代码由三位数字组成，第一位定义了响应的类别：
1xx:指示信息——表示请求已接收，继续处理。
2xx:成功——表示请求已被成功接收、理解、接受。
3xx:重定向——要完成请求必须进行更进一步的操作。
4xx:客户端错误——请求有语法错误或请求无法实现。
5xx:服务器端错误——服务器未能实现合法的请求。
200 OK 客户端请求成功
206 客户端发送了带有Range头的GET请求，服务器正确的返回了该范围的数据
302/307 指出被请求的文档已经临时移动到别处，此文档的新的URL在Location响应头中给出
304 客户机缓存的版本是最新的，客户机应该继续使用它
400 Bad Request 客户端请求有语法错误，不能被服务器理解
401 Unauthorized 表示客户机访问的是一个受口令和密码保护的页面，并且在WWW-Authenticate响应头提示客户机应重新发出一个带有Authorization头的请求信息。
403 Forbidden服务器收到请求，但是拒绝提供服务
404 Not Found 请求的资源不存在
500 Internal Server Error服务器端的CGI、ASP、JSP发生错误
503 Server Unavaliable服务器当前不能处理客户端的请求，一段时间后可能恢复正常
ps:转载自：http://www.cnblogs.com/YinWangLive/archive/2009/04/10/1433330.html

看到这些基本了解到用串口助手发送数据回来400/404/500 等错误信息的基本含义了。但协议本身有有些迷糊，错误信息怎么找到了，最重要的方法还是看文档，然后依据文档的方法调试。以下是我调试好的数据包，大家可以看下。
1 数据流
1.1数据流上传
POST /devices/680869/datapoints HTTP/1.1
api-key: bryNFvy6sbj9Isu5mHXp3fwIvtc=
Host:api.heclouds.com
Connection:close
Content-Length:59

{“datastreams”:[{“id”:“temp”,“datapoints”:[{“value”:50}]}]}
ps:这是默认的数据流上传方式。如果想要长连接Connection:close 这句要删除，HTTP/1.1这里要写。如果写HTTP/1.0就是发送一次数据然后网站就断开连接了。
如果想要简化数据包，需要在头文件修改数据包传输协议。我这里选择方式3 。POST /devices/680869/datapoints?type=3 HTTP/1.1

1.2发送一个设备上的N个数据流
POST /devices/680869/datapoints?type=3 HTTP/1.1
api-key: bryNFvy6sbj9Isu5mHXp3fwIvtc=
Host:api.heclouds.com
Connection:close
Content-Length:23

{“shidu”:22,“wendu”:22}
ps: Content-Length:23 后的换行符号一定要。{“shidu”:22,“wendu”:22} 后的换行符可以不要，但尽量使用换行符，这是个习惯问题。23是指数据包{“shidu”:22,“wendu”:22}的字符数字，汉字也遵循相似的规则，字符的长度不包括前后的换行符，数字的大小谨慎使用。比如改为22会出现如下效果
12:32:52 收到数据：HTTP/1.1 200 OK
Date: Wed, 04 May 2016 04:32:34 GMT
Content-Type: application/json
Content-Length: 34
Connection: close
Server: Apache-Coyote/1.1
Pragma: no-cache
{“errno”:4,“error”:“invalid JSON”}
数据长度改为24,25没有问题，但改为26，服务器就没有反应了。个人猜测网站设计时，一段HTTP协议发送完成后允许换行和不换行共存，23-25长度下数据均可正常上传，这是网站设计时考虑的一些使用者习惯问题。

1.3发送一个设备上的N个数据流例2
当然一次上传可以上传某项目中的一个设备的N个数据流。跨项目这是不行的，因为APIKEY不一致。跨设备好像不行，没有仔细研究。下面介绍我的上传开关信息http协议
POST /devices/680872/datapoints?type=3 HTTP/1.1 api-key: vUAoLurFOH=xkqr9s7w4dXuXBGY=
Host:api.heclouds.com
Connection:close
Content-Length:42
{“taideng”:0,“diandengl”:0,“diandeng2”:1}
返回的数据如下：
12:45:46 收到数据：HTTP/1.1 200 OK
Date: Wed, 04 May 2016 04:45:28 GMTContent-Type: application/json
Content-Length: 26
Connection: close
Server: Apache-Coyote/1.1
Pragma: no-cache

{“errno”:0,“error”:“succ”}
2 除了上传数据之外，还需要获取数据，比如改变了开关值，设备需要主动获取开关值，设备才可以达到远程控制的目的。
2.1获取设备多个数据流
GET /devices/680872/datastreams HTTP/1.1
api-key: vUAoLurFOH=xkqr9s7w4dXuXBGY=
Host:api.heclouds.com
Connection:close

返回的数据如下：
{“errno”:0,“data”:[{“create_time”:“2016-01-14 09:34:17”,“update_at”:“2016-05-04 12:45:28”,“id”:“taideng”,“uuid”:“f498ffdb-b639-5596-9081-90072c4396d3”,“current_value”:0},{“create_time”:“2016-01-13 20:01:27”,“update_at”:“2016-05-02 22:40:09”,“id”:“diandeng1”,“uuid”:“0486063b-0e01-5e1b-a21d-bd9a90347d43”,“current_value”:0},{“create_time”:“2016-01-14 09:34:24”,“update_at”:“2016-05-04 12:45:28”,“id”:“diandeng2”,“uuid”:“a551ca79-4fb4-542c-84a0-3537ecf84875”,“current_value”:1},{“create_time”:“2016-05-04 10:09:22”,“update_at”:“2016-05-04 12:45:28”,“id”:“diandengl”,“uuid”:“5e0ba4db-e85e-4d8e-b706-4e04e88bf8bb”,“current_value”:0}],“error”:“succ”}
ps:Connection:close 后面要加两个换行符，否则服务器没有响应的。

2.2 读取设备单个数据流
GET /devices/680872/datastreams/taideng HTTP/1.1
api-key: vUAoLurFOH=xkqr9s7w4dXuXBGY=
Host:api.heclouds.com
Connection:close

返回数据
Date: Wed, 04 May 2016 04:54:26 GMT
Content-Type: application/json
Content-Length: 138
Connection: close
Server: Apache-Coyote/1.1
Pragma: no-cache

{“errno”:0,“data”:{“create_time”:“2016-01-14 09:34:17”,“update_at”:“2016-05-04 12:45:28”,“id”:“taideng”,“current_value”:0},“error”:“succ”}

3 设备
这里我觉得设备和数据流没有什么区别，只是方便app,微信开发的，省去网站注册麻烦。这里就略过。但还是要写下我的笔记。
3.1读取多个设备
GET /devices HTTP/1.1
api-key: vUAoLurFOH=xkqr9s7w4dXuXBGY=
Host:api.heclouds.com
Connection:close
返回数据：
{“errno”:0,“data”:{“per_page”:30,“devices”:[{“private”:false,“protocol”:“HTTP”,“create_time”:“2016-01-15 08:20:35”,“location”:{“lon”:114.39322112330001,“lat”:30.508559475486003},“id”:“680997”,“auth_info”:{“SYS”:“WYfjhCGqU2ks4ltBQe02kkWTYxE=”},“title”:“鐢电伅鎺у埗2”,“desc”:“瀹ゅ鐢电伅鎺у埗”,“tags”:[“瀹ゅ鐢电伅鎺у埗”]},{“private”:false,“protocol”:“HTTP”,“create_time”:“2016-01-13 19:59:02”,“location”:{“lon”:114.45659857426999,“lat”:30.470787904259},“auth_info”:{“SYS”:“Sonv4XxoF68E82739gfef1NTu3g=”},“id”:“680872”,“title”:“鐢电伅”,“desc”:“鐢电伅”,“tags”:["鐢电伅鐘舵€?]}],“total_count”:2,“page”:1},“error”:“succ”}

3.2读取单个设备具体信息
Date: Wed, 04 May 2016 05:01:05 GMT
Content-Type: application/json
Content-Length: 140
Connection: close
Server: Apache-Coyote/1.1
Pragma: no-cache

{“errno”:0,“data”:[{“create_time”:“2016-01-14 09:34:17”,“update_at”:“2016-05-04 12:45:28”,“id”:“taideng”,“current_value”:0}],“error”:“succ”}

3.3读取触发器 温度高触发器
GET /triggers/11608 HTTP/1.1
api-key: bryNFvy6sbj9Isu5mHXp3fwIvtc=
Host:api.heclouds.com
Connection:close

返回数据：
Date: Wed, 04 May 2016 05:02:41 GMT
Content-Type: application/json
Content-Length: 191
Connection: close
Server: Apache-Coyote/1.1
Pragma: no-cache

{“errno”:0,“data”:{“invalid”:true,“dev_ids”:[“680869”],“threshold”:20,“id”:11608,“title”:“hightemp”,“type”:">=",“ds_id”:“wendu”,“url”:“http://api.heclouds.com/devices/680869"},“error”:"succ”}

3.4读触发器。电灯1触发器
GET /triggers/11610 HTTP/1.1
api-key: vUAoLurFOH=xkqr9s7w4dXuXBGY=
Host:api.heclouds.com
Connection:close

返回数据：
Date: Wed, 04 May 2016 05:04:17 GMT
Content-Type: application/json
Content-Length: 171
Connection: close
Server: Apache-Coyote/1.1
Pragma: no-cache

{“errno”:0,“data”:{“dev_ids”:[“680872”],“id”:11610,“title”:“寮€鐢电伅1”,“type”:“change”,“ds_id”:“diandeng1”,“url”:“http://api.heclouds.com/devices/680872"},“error”:"succ”}
3.5获取数据点
GET /devices/680869/datapoints HTTP/1.1
api-key: bryNFvy6sbj9Isu5mHXp3fwIvtc=
Host:api.heclouds.com
Connection:close

返回数据
Date: Wed, 04 May 2016 05:04:17 GMT
Content-Type: application/json
Content-Length: 209
Connection: close
Server: Apache-Coyote/1.1
Pragma: no-cache

{“errno”:0,“data”:{“count”:2,“datastreams”:[{“datapoints”:[{“at”:“2016-05-04 13:05:05.701”,“value”:19}],“id”:“shidu”},{“datapoints”:[{“at”:“2016-05-04 13:05:05.704”,“value”:30}],“id”:“wendu”}]},“error”:“succ”}
4二进制
4.1上传二进制
POST /bindata?device_id=1078739&datastream_id=ir HTTP/1.1
api-key: bryNFvy6sbj9Isu5mHXp3fwIvtc=
Host:api.heclouds.com
Content-Length:1

0

13:08:05 收到数据：HTTP/1.1 200 OK
Date: Wed, 04 May 2016 05:07:47 GMT
Content-Type: application/json
Content-Length: 70
Connection: keep-alive
Server: Apache-Coyote/1.1
Pragma: no-cache

{“errno”:0,“data”:{“index”:“1078739_1462338467786_ir”},“error”:“succ”}
ps:收到的数据中我可能忘了把一些附加信息粘贴上去，但这不影响效果。

5历史数据
读取历史数据：
GET /datapoints?start=2015-12-02T14:01:46&device_id=978118&limit=6000 HTTP/1.1
api-key: bryNFvy6sbj9Isu5mHXp3fwIvtc=
Host:api.heclouds.com
Connection:close

返回数据：
{“errno”:0,“data”:{“datapoints”:[{“at”:“2016-03-28 09:41:52.278”,“ds_id”:“temp2”,“value”:22,“dev_id”:“978118”},{“at”:“2016-04-19 19:58:56.147”,“ds_id”:“temp2”,“value”:22,“dev_id”:“978118”},{“at”:“2016-05-04 10:40:42.551”,“ds_id”:“temp2”,“value”:22,“dev_id”:“978118”},{“at”:“2016-03-28 09:41:52.281”,“ds_id”:“temp1”,“value”:22,“dev_id”:“978118”},{“at”:“2016-04-19 19:58:56.150”,“ds_id”:“temp1”,“value”:22,“dev_id”:“978118”},{“at”:“2016-05-04 10:40:42.558”,“ds_id”:“temp1”,“value”:22,“dev_id”:“978118”}],“count”:6},“error”:“succ”}