Arduino ESP8266 创建OneNet设备（二）

矫情吗；* 2022-04-04 05:26 509阅读 0赞

## 用户注册 ##

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

填写用户名、用户密码、有效手机号码，点击获取验证码，查看短信验证码，并完成注册；  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 1]

注册完成后，自动回到主页，通过右上角入口登录，登录后进入到我们的“开发者中心”。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 2]

## 产品创建 ##

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

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

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

## 通信准备 ##

首先，我们需要建立属于自己的设备数据流，如下所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 6]

数据流建立好了，摘出通信所需的数据信息：**设备ID、设备名称、Master-APIkey等**，  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 7]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 8]

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

传输格式如下所示：

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][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域，可以建立虚拟主机。

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

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

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

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

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

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

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

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

CONNECT：保留将来使用

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

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

1.  状态行  
    结构：HTTP版本号\_状态码\_状态描述(CRLF)如：HTTP/1.1 200 OK
2.  使用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:指示信息&mdash;&mdash;表示请求已接收，继续处理。  
2xx:成功&mdash;&mdash;表示请求已被成功接收、理解、接受。  
3xx:重定向&mdash;&mdash;要完成请求必须进行更进一步的操作。  
4xx:客户端错误&mdash;&mdash;请求有语法错误或请求无法实现。  
5xx:服务器端错误&mdash;&mdash;服务器未能实现合法的请求。  
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][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”:\["鐢电伅鐘舵&euro;?\]\}\],“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][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”:“寮&euro;鐢电伅1”,“type”:“change”,“ds\_id”:“diandeng1”,“url”:“[http://api.heclouds.com/devices/680872"\},“error”:"succ][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

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”\}

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70]: /images/20220404/20fec5130fe94035acd266309704f7d2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 1]: /images/20220404/f43cbd797ad444a09f343564f0afdacc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 2]: /images/20220404/d36c8599a706449a8f1594180a1b9614.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 3]: /images/20220404/34162d816a9a445ca89ab16be8805fff.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 4]: /images/20220404/0282a80f46154fe98b8c558b4d40b385.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 5]: /images/20220404/b2d9b6972bcf446a8fa73f191cc67295.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 6]: /images/20220404/915b9f6696324f369e42903d1b8b1377.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 7]: /images/20220404/4da4e97313c44084b69af96ba5ffe4e0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzM3NzM4ODM4_size_16_color_FFFFFF_t_70 8]: /images/20220404/d6f7ae6cd36d4731bec3c4e496a3cfc2.png
[https_open.iot.10086.cn_iotbox_appsquare_appview_openid_5ca523334a5a9b576e316a586de6d738]: https://open.iot.10086.cn/iotbox/appsquare/appview?openid=5ca523334a5a9b576e316a586de6d738
[http_www.cnblogs.com_YinWangLive_archive_2009_04_10_1433330.html]: http://www.cnblogs.com/YinWangLive/archive/2009/04/10/1433330.html
[http_api.heclouds.com_devices_680869_error_succ]: http://api.heclouds.com/devices/680869%22%7D,%22error%22:%22succ
[http_api.heclouds.com_devices_680872_error_succ]: http://api.heclouds.com/devices/680872%22%7D,%22error%22:%22succ