本帖最后由 单片机菜鸟 于 2019-11-28 09:16 编辑
[md]![image]()
## 1.理论基础
参考博主线上博文:
- **玩转OneNET物联网平台之简介**
- **ESP8266开发之旅 网络篇⑨ HttpClient——ESP8266HTTPClient库的使用**
## 2.OneNet HTTP
Http协议作为常用网络协议,其为短连接协议(这里不讲解HTTP协议,请读者自行查阅资料),在OneNet平台上也同样支持。
**设备侧适用特点**:
- 只上报传感器数据到平台
- 无需下行控制质量到设备
**平台侧提供功能**:
- 存储设备上报的数据点;
- 提供API接口实现设备管理;
- 提供数据推送到应用;
**典型适用场景**
- 简单数据上报场景,比如温湿度控制系统等传感器检测类项目;
## 3.模拟上传温度
### 3.1 实验材料
- ESP8266 NodeMcu
- OneNet平台
### 3.2 实验步骤
#### 3.2.1 创建 温湿度系统-HTTP 产品(HTTP协议)
![image]()
**注意点**:
- 务必选择HTTP协议
创建完毕后,我们点击查看具体的产品信息:
![image]()
**注意点**:
- 需要记录产品ID,其用来区分产品唯一标识符
- Master-APIkey,网络请求鉴权信息,接口调用需要带入
#### 3.2.2 API调试创建 deviceA
**API接口定义**:
- 参考官方文档 [创建设备](https://open.iot.10086.cn/doc/book/application-develop/api/TCP/1.%E6%96%B0%E5%A2%9E%E8%AE%BE%E5%A4%87.html)
**操作步骤**:
- 通过API调试工具创建deviceA
![image]()
**http body**:
```c
{
"title": "http_device_A",
"desc": "http_device_A",
"tags": ["china", "mobile"],
"location": {
"lon": 109,
"lat": 23.54
},
"auth_info": "http_device_A",
"other": {
"version": "1.0.0",
"manufacturer": "china mobile"
}
}
```
- 查看设备列表
![image]()
#### 3.2.3 API调试模拟上传温度 —— deviceA
**API接口定义**:
- 参考官方文档 [新增数据点](https://open.iot.10086.cn/doc/book/application-develop/api/TCP/15.%E4%B8%8A%E4%BC%A0%E6%95%B0%E6%8D%AE%E7%82%B9.html)
**操作步骤**:
- 通过API调试工具发送请求
![image]()
- 查看操作结果
![image]()
![image]()
#### 3.2.4 NodeMcu烧录代码 —— deviceA
为了明确区分代码功能,博哥命名工程名为P_OneNet_Exam02:
- **P_OneNet_Exam02.ino**文件:
```c
/**
* 功能:ESP8266 HTTP 远程上传温度值 V1.0
* 作者:单片机菜鸟
* 时间:2019-06-27
* 描述:
* 1.OneNet平台端:创建Http协议的产品,创建DeviceA设备点
* 2.每个20s上传一个随机值给到OneNet平台
*/
#include <ESP8266WiFi.h>
#include <ArduinoJson.h>
#include <stdlib.h>
#include <Ticker.h>
#include "H_project.h"
void initSystem();
void wifiTick();
void postTempToOneNet();
/**
* 初始化
*/
void setup() {
initSystem();
}
void loop() {
ESP.wdtFeed();
wifiTick();
doTCPClientTick();
postTempToOneNet();
}
/**
* 初始化系统
*/
void initSystem(){
int cnt = 0;
Serial.begin (115200);
Serial.println("\r\n\r\nStart ESP8266 HTTP");
Serial.print("Firmware Version:");
Serial.println(VER);
Serial.print("SDK Version:");
Serial.println(ESP.getSdkVersion());
wifi_station_set_auto_connect(0);//关闭自动连接
ESP.wdtEnable(5000);
WiFi.disconnect();
delay(100);
WiFi.begin(ssid, password);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
cnt++;
Serial.print(".");
if(cnt>=40){
cnt = 0;
//重启系统
delayRestart(1);
}
}
pinMode(LED_BUILTIN, OUTPUT);
}
/*
* WiFiTick
* 检查是否需要初始化WiFi
* 检查WiFi是否连接上,若连接成功启动TCP Client
* 控制指示灯
*/
void wifiTick(){
static bool taskStarted = false;
static bool ledTurnon = false;
if ( WiFi.status() != WL_CONNECTED ) {
if (millis() - lastWiFiCheckTick > 1000) {
lastWiFiCheckTick = millis();
ledState = !ledState; digitalWrite(LED_BUILTIN, ledState);
ledTurnon = false;
}
}else{
if (ledTurnon == false) {
ledTurnon = true;
digitalWrite(LED_BUILTIN, 0);
}
if (taskStarted == false) {
taskStarted = true;
startTCPClient();
}
}
}
/**
* 检查client连接
*/
void doTCPClientTick(){
//检查是否断开,断开后重连
if(WiFi.status() != WL_CONNECTED) return;
if (!client.connected()) {//断开重连
if(preTCPConnected == true){
preTCPConnected = false;
preTCPStartTick = millis();
Serial.println();
Serial.println("TCP Client disconnected.");
client.stop();
}else if(millis() - preTCPStartTick > 10*1000){
startTCPClient();
}
}
}
/**
* 启动Tcp client
*/
void startTCPClient(){
Serial.println("\r\nstartTCPClient");
if(client.connect(host, 80)){
preTCPConnected = true;
client.setNoDelay(true);
}else{
Serial.print("Failed connected to server:");
Serial.println(host);
client.stop();
preTCPConnected = false;
}
preTCPStartTick = millis();
}
/**
* 提交数据到OneNet
*/
void postTempToOneNet(){
if(WiFi.status() != WL_CONNECTED || !client.connected()) return;
if(millis() - lastOneNetPostTick > 15*1000){
lastOneNetPostTick = millis();
Serial.println("TCP Client postTempToOneNet.");
StaticJsonBuffer<230> jsonBuffer;
//创建根,也就是顶节点
JsonObject& root = jsonBuffer.createObject();
//在root对象中加入data数组
JsonArray& datastreams = root.createNestedArray("datastreams");
JsonObject& stream = datastreams.createNestedObject();
stream["id"] = "temperature";
JsonArray& datapoints = stream.createNestedArray("datapoints");
JsonObject& value1 = datapoints.createNestedObject();
value1["value"] = random(20, 50);
JsonObject& value2 = datapoints.createNestedObject();
value2["value"] = random(20, 50);
int len = root.measureLength();
char buffer[100];
root.printTo(buffer, 100);
String data;
for(int index = 0;index<len;index++){
data += buffer[index];
}
postToDeviceDataPoint(data);
}
}
```
- H_project.h 代码:
```c
#ifndef _MAIN_H__
#define _MAIN_H__
extern "C" {
#include "user_interface.h"
#include "smartconfig.h"
}
/************** ESP8266相关操作 **************************/
void delayRestart(float t);
void delayNs(uint8_t m);
/*********************************************************/
/******************** Http 相关操作 **********************/
const unsigned long HTTP_TIMEOUT = 5000;// max respone time from server
const size_t MAX_CONTENT_SIZE = 500;// max size of the HTTP response
WiFiClient client;
char response[MAX_CONTENT_SIZE];
char endOfHeaders[] = "\r\n\r\n";
bool sendGetRequest(const char* host,String url,String header,char* response);
bool sendPostRequest(const char* host,String url,String header,String postData,char* response);
bool skipResponseHeaders();
void readReponseContent(char* content, size_t maxSize);
void clearResponseBuffer(char* response);
/*********************************************************/
/*************** OneNet HTTP相关操作 *********************/
const char* host = "api.heclouds.com";
bool postToDeviceDataPoint(String data);
/*********************************************************/
/*********************** 项目相关操作 ********************/
#define VER "HTTP_TEMP_V1.0"
const char* ssid = "TP-LINK_5344";//wifi账号
const char* password = "xxxxxx";//wifi秘密
const unsigned long BAUD_RATE = 115200;// serial connection speed
unsigned long lastWiFiCheckTick = 0;
bool ledState = 0;
unsigned long lastOneNetPostTick=0;
unsigned long preTCPStartTick=0;
bool preTCPConnected=false;
/*********************************************************/
#endif
```
全部工程代码,博哥放在个人QQ群里。
![image]()
**注意点**:
- 这里用到了JSON,请参考博哥上线博文 **玩转ArduinoJson库 V5版本**;
- 我们这里使用到了ESP8266 WiFiClient来封装Http请求(也可以直接使用HttpClient库),为了加深理解,请读者参考博哥上线博文 **ESP8266开发之旅 网络篇⑦ TCP Server & TCP Client** 关于client部分;
把工程烧进NodeMcu,然后可以看到串口打印内容,如下:
![image]()
同时,也可以在OneNet平台看到数据流情况,如下:
![image]()
## 4.总结
在理解HTTP协议的基础上,本篇是非常容易操作的。但是读者也需要关注几点:
- 创建自己的OneNet产品,不要用博哥创建的(请在博哥源码基础上修改自己的产品信息);
- 可以尝试加入优化代码,比如温度值不变,是否考虑不上传,或者加大上传间隔,也或者加入睡眠模式
下一篇,博哥将讲解 玩转OneNET物联网平台之HTTP服务② —— 模拟上传温度(HttpClient)。
**个人免费交流群:ESP物联网开发之旅 622368884**
[/md]
|