Arduino ESP8266 创建OneNet设备（二）

其他 2018-12-24 18:14:50 阅读次数: 0
版权声明：本文为博主原创文章，未经博主允许不得转载 https://blog.csdn.net/m0_37738838/article/details/85012065

用户注册

用户注册和产品创建我们在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域，可以建立虚拟主机。

  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:指示信息——表示请求已接收，继续处理。
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”}

猜你喜欢

转载自blog.csdn.net/m0_37738838/article/details/85012065
今日推荐
火速冲上 GitHub 热榜 —— 开源编程语言、框架哪有这么可爱？
北京人形机器人创新中心发布全球首个纯电驱拟人奔跑的全尺寸人形机器人“天工”
LFOSSA 源来如此公开课 | 掌握云原生未来：CNCF 认证全面攻略与备考秘籍
国产云输入法——仅华为无云端数据上传安全问题
开源日报 | 工业开源项目OGG 1.0；姐姐，你要和我一起配置火狐吗；苹果AI遥遥落后？Fedora 40
开放签电子签章：停止新增，优化体验，前进更进（五一假期前工作）
开源日报 | 中学生开源前端动画引擎；全球首个Llama3 8B中文版开源模型；联想电脑恐出局；Linus讽刺AI炒作
周排行
浏览器对同一域名进行请求的最大并发连接数
React Hook之自定义Hook
【转】MyBatis缓存机制
-Java-泛型
自动化测试常用脚本-发送邮件
LeetCode#859: Buddy Strings
java、Python处理字符串
第二篇の博客
Hadoop伪分布式环境安装
SQL Server进阶（十一）临时表、表变量
每日归档
更多
2024-04-27(56)
2024-04-26(39)
2024-04-25(22)
2024-04-24(36)
2024-04-23(26)
2024-04-22(39)
2024-04-21(0)
2024-04-20(6)
2024-04-19(5)
2024-04-18(0)

代码天地 © 2018 codetd.com

境外服务器   最新电视剧2022