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

版权声明：署名，允许他人基于本文进行创作，且必须基于与原先许可协议相同的许可协议分发本文 （Creative Commons）

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