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协议）
注意点：
- 务必选择HTTP协议
创建完毕后，我们点击查看具体的产品信息：
注意点：
- 需要记录产品ID，其用来区分产品唯一标识符
- Master-APIkey，网络请求鉴权信息，接口调用需要带入
3.2.2 API调试创建 deviceA
API接口定义：
扫描二维码关注公众号，回复：
6660773 查看本文章
- 参考官方文档 创建设备
操作步骤：
- 通过API调试工具创建deviceA
http body：
{
"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"
}
}- 查看设备列表
3.2.3 API调试模拟上传温度 —— deviceA
API接口定义：
- 参考官方文档 新增数据点
操作步骤：
- 通过API调试工具发送请求
- 查看操作结果
3.2.4 NodeMcu烧录代码 —— deviceA
为了明确区分代码功能，博哥命名工程名为P_OneNet_Exam02:
- P_OneNet_Exam02.ino文件：
/**
* 功能：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 代码:
#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群里。
注意点：
- 这里用到了JSON，请参考博哥上线博文 玩转ArduinoJson库 V5版本；
- 我们这里使用到了ESP8266 WiFiClient来封装Http请求（也可以直接使用HttpClient库），为了加深理解，请读者参考博哥上线博文 ESP8266开发之旅 网络篇⑦ TCP Server & TCP Client 关于client部分；
把工程烧进NodeMcu，然后可以看到串口打印内容，如下：
同时，也可以在OneNet平台看到数据流情况，如下：
4.总结
在理解HTTP协议的基础上，本篇是非常容易操作的。但是读者也需要关注几点：
- 创建自己的OneNet产品，不要用博哥创建的（请在博哥源码基础上修改自己的产品信息）；
- 可以尝试加入优化代码，比如温度值不变，是否考虑不上传，或者加大上传间隔，也或者加入睡眠模式
下一篇，博哥将讲解 玩转OneNET物联网平台之HTTP服务② —— 模拟上传温度（HttpClient）。