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

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接口定义：

• 参考官方文档 创建设备

操作步骤：

• 通过API调试工具创建deviceA

image

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"
    }
}

• 查看设备列表

image

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

API接口定义：

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

操作步骤：

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

image

• 查看操作结果

  
  
  

  image

image

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

• 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群里。

image

注意点：

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

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

image

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

image

4.总结

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

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

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