❤️博主介绍❤️
😬 作者:单片机菜鸟哥
👉火爆博客:ESP8266 Arduino教程
零基础从入门到熟悉Arduino平台下开发ESP8266,同时会涉及网络编程知识。专栏文章累计超过60篇,分为基础篇、网络篇、应用篇、高级篇,涵盖ESP8266大部分开发技巧。
👻最近更新:ESP32 MicroPython应用
讲解Python在esp32上的应用,包括网络请求、爬虫
如果觉得有用,麻烦点赞收藏,您的支持是博主创作的动力。
文章目录
1.理论基础
参考博主线上博文:
- 玩转OneNET物联网平台之简介
- ESP8266开发之旅 网络篇⑨ HttpClient——ESP8266HTTPClient库的使用
- 玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)
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接口定义:
- 参考官方文档 创建设备
操作步骤:
- 通过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_Exam03:
- P_OneNet_Exam03.ino文件:
/**
* 功能:ESP8266 HTTP 远程上传温度值 V1.0
* 作者:单片机菜鸟
* 时间:2019-06-27
* 描述:
* 1.OneNet平台端:创建Http协议的产品,创建DeviceA设备点
* 2.每个20s上传一个随机值给到OneNet平台
*/
#include <ESP8266WiFi.h>
#include <ArduinoJson.h>
#include <ESP8266HTTPClient.h>
#include <stdlib.h>
#include <Ticker.h>
#include "H_project.h"
void initSystem();
void wifiTick();
bool postTempToOneNet();
int retry = 0;
/**
* 初始化
*/
void setup() {
initSystem();
}
void loop() {
ESP.wdtFeed();
wifiTick();
if(millis() - lastOneNetPostTick > 30*1000){
lastOneNetPostTick = millis();
if(postTempToOneNet()){
retry = 0;
}else{
retry ++;
if(retry == 20){
retry = 0;
delayRestart(1);
}
}
}
}
/**
* 初始化系统
*/
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是否连接上
* 控制指示灯
*/
void wifiTick(){
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);
}
}
}
/**
* 提交数据到OneNet
*/
bool postTempToOneNet(){
if(WiFi.status() != WL_CONNECTED) return false;
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];
}
return 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);
/*********************************************************/
/*************** OneNet HTTP相关操作 *********************/
WiFiClient client;
HTTPClient http;
String response;
const char* host = "api.heclouds.com";
bool postToDeviceDataPoint(String data);
/*********************************************************/
/*********************** 项目相关操作 ********************/
#define VER "HTTP_TEMP_V1.1"
const char* ssid = "TP-LINK_5344";//wifi账号
const char* password = "6206908you11011010";//wifi秘密
const unsigned long BAUD_RATE = 115200;// serial connection speed
unsigned long lastWiFiCheckTick = 0;
bool ledState = 0;
unsigned long lastOneNetPostTick=0;
/*********************************************************/
#endif
全部工程代码,博哥放在个人QQ群里 或者 代码下载地址。
注意点:
- 这里用到了JSON,请参考博哥上线博文 玩转ArduinoJson库 V5版本;
- 我们这里使用到了ESP8266 HttpClient来封装Http请求;
把工程烧进NodeMcu,然后可以看到串口打印内容,如下:
同时,也可以在OneNet平台看到数据流情况,如下:
4.总结
在理解HTTP协议的基础上,本篇是非常容易操作的。但是读者也需要关注几点:
- 创建自己的OneNet产品,不要用博哥创建的(请在博哥源码基础上修改自己的产品信息);
- 可以尝试加入优化代码,比如温度值不变,是否考虑不上传,或者加大上传间隔,也或者加入睡眠模式