玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)

授人以鱼不如授人以渔,目的不是为了教会你具体项目开发,而是学会学习的能力。希望大家分享给你周边需要的朋友或者同学,说不定大神成长之路有博哥的奠基石。。。

快速导航
单片机菜鸟的博客快速索引(快速找到你要的)

如果觉得有用,麻烦点赞收藏,您的支持是博主创作的动力。

文章目录

    • 1.理论基础
    • 2.OneNet HTTP
    • 3.模拟上传温度
      • 3.1 实验材料
      • 3.2 实验步骤
        • 3.2.1 创建 温湿度系统-HTTP 产品(HTTP协议)
        • 3.2.2 API调试创建 deviceA
        • 3.2.3 API调试模拟上传温度 —— deviceA
        • 3.2.4 NodeMcu烧录代码 —— deviceA
    • 4.总结

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协议)

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第1张图片

注意点

  • 务必选择HTTP协议

    创建完毕后,我们点击查看具体的产品信息:

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第2张图片

注意点

  • 需要记录产品ID,其用来区分产品唯一标识符
  • Master-APIkey,网络请求鉴权信息,接口调用需要带入

3.2.2 API调试创建 deviceA

API接口定义

  • 参考官方文档 创建设备

操作步骤

  • 通过API调试工具创建deviceA

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第3张图片

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"
    }
}
  • 查看设备列表

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第4张图片

3.2.3 API调试模拟上传温度 —— deviceA

API接口定义

  • 参考官方文档 新增数据点

操作步骤

  • 通过API调试工具发送请求

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第5张图片

  • 查看操作结果
    玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第6张图片

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第7张图片

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 
#include 
#include 
#include 
#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群里 或者 代码下载地址。

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第8张图片

注意点

  • 这里用到了JSON,请参考博哥上线博文 玩转ArduinoJson库 V5版本
  • 我们这里使用到了ESP8266 WiFiClient来封装Http请求(也可以直接使用HttpClient库),为了加深理解,请读者参考博哥上线博文 ESP8266开发之旅 网络篇⑦ TCP Server & TCP Client 关于client部分;

    把工程烧进NodeMcu,然后可以看到串口打印内容,如下:

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第9张图片

    同时,也可以在OneNet平台看到数据流情况,如下:

玩转OneNET物联网平台之HTTP服务① —— 模拟上传温度(TcpClient)_第10张图片

4.总结

在理解HTTP协议的基础上,本篇是非常容易操作的。但是读者也需要关注几点:

  • 创建自己的OneNet产品,不要用博哥创建的(请在博哥源码基础上修改自己的产品信息);
  • 可以尝试加入优化代码,比如温度值不变,是否考虑不上传,或者加大上传间隔,也或者加入睡眠模式

下一篇,博哥将讲解 玩转OneNET物联网平台之HTTP服务② —— 模拟上传温度(HttpClient)。

你可能感兴趣的:(玩转OneNet教程)