【教程】ESP32连接华为云IoT平台

目录

1前言

2应用侧接入华为云IoT平台

3必备环境

4使用步骤

4.1华为云IoT平台简介

4.2产品定义

4.3设备定义与注册

4.4ESP32编程接入

4.4.1头文件的包含

4.4.2接入参数以及ESP32WiFi的配置

4.4.3WiFi配置与MQTT连接初始化

4.4.4属性上报

4.4.5接收华为云IoT平台下发命令以及命令响应

原创不易,点个赞或者点个关注激励笔者分享更多优质原创内容吧!

开源万岁!


1前言

        相信很多人和笔者一样,参加各种比赛时,都选择了有关华为IoT平台的命题。可惜全网搜寻一番,发现硬件设备与华为云IoT连接的教程几乎没有,大多数是腾讯云、阿里云或者ONENET平台的。经过自己的摸索,终于连接上华为云IoT平台实现相关功能,所以今天的这一篇教程便是ESP32连接华为云IoT平台的教程。

        相比较于以前做过的STM32+ESP8266实现上华为云,ESP32上云可以说是十分十分简单了。

        首先STM32与8266使用的是串口通信发送AT指令的方案,连接服务器的过程总是不太灵敏,且对于待发送或者接收的JSON包难以编码和解析。

        而ESP32自带WiFi模块,使用其PubSubClient库可以方便的做到与服务器连接以及通信,至于JSON格式的处理可以使用ArduinoJSON库。

2应用侧接入华为云IoT平台

关于应用侧和华为云IoT平台的连接,数据流转等功能的使用教程,笔者的一位朋友已经在着手撰写,后面将在这篇文章更新其文章链接,望大家多多催更:D

此处为更新的文章:

【教程】应用侧连接华为云IoT平台_叫我胡萝北的博客-CSDN博客

3必备环境

Arduino IDE

ESP32

PubSubClient库

ArduinoJSON库(V5和V6的代码语法会有一些差别,笔者使用的是V5版本的库)

这是ArduinoJSON库的官方网站ArduinoJson: Efficient JSON serialization for embedded C++

4使用步骤

4.1华为云IoT平台简介

  • 百度搜索华为云,点击进入华为云
  • 硬件接入华为云IoT需要用到华为云的 产品-> IoT物联网->设备接入IoTDA

科普一下,此处的DA是Device Access的意思,表示设备接入

【教程】ESP32连接华为云IoT平台_第1张图片

  • 新手点击免费试用即可

【教程】ESP32连接华为云IoT平台_第2张图片

  • 在左侧的边栏中可以看到一系列的选项

 【教程】ESP32连接华为云IoT平台_第3张图片

  • 下面对一些常用的选项进行说明

总览:呈现了平台的接入地址以及一些新手引导,建议新手可以根据引导观看,倒数第四个“产品文档”项也提供了软硬件与华为云IoT平台的交互的详细文档,建议新手仔细阅读

产品:顾名思义,这是定义和查看你拥有的产品的地方

设备:一个产品名下可以拥有很多设备,在这里可以定义设备,并对其参数进行修改或进行命令的下发

监控运维:包含 “在线调试” 和 “消息跟踪” 等功能,在线调试可以进行命令下发,参数设置等操作;而消息跟踪则是跟踪硬件设备一段时间内和平台的交互

4.2产品定义

  • 首先定义一个产品(产品-> 创建产品),协议类型选择MQTT,其他参数随产品而定

【教程】ESP32连接华为云IoT平台_第4张图片

  • 然后依次点击产品-> 选择你的产品-> 模型定义-> 自定义模型

PS:这里要来定义产品的服务,比如一个物联网的智能配送车就可以有一个订单服务

而订单服务下面又可以分为很多种属性,比如订单下发的命令,订单当前状态的查看,订单配送的命令 

 【教程】ESP32连接华为云IoT平台_第5张图片

  • 我们填写一下服务的相关信息

【教程】ESP32连接华为云IoT平台_第6张图片

  • 添加好服务后,可以在服务下添加该产品的属性和命令参数,这一步完成后,产品就算定义完成啦

【教程】ESP32连接华为云IoT平台_第7张图片

4.3设备定义与注册

  • 产品定义好后,我们来定义设备

依次点击设备-> 所有设备-> 注册设备

选择所属的产品

【教程】ESP32连接华为云IoT平台_第8张图片

  • 单击确定后出现下面的页面提示设备创建成功,点击保存并关闭,会自动下载设备的"device_id" 和 "secret",保存好这个文件。

【教程】ESP32连接华为云IoT平台_第9张图片

 【教程】ESP32连接华为云IoT平台_第10张图片

  •  这样就算注册好设备了,但是注意,此时真实的硬件设备并没有和华为云IoT平台连接,所以会显示未激活状态

4.4ESP32编程接入

4.4.1头文件的包含

这四个头文件都是必须的

#include 
#include 
#include 
#include 

4.4.2接入参数以及ESP32WiFi的配置

将其中的参数按照实际情况修改

/*MQTT连接配置*/
/*-----------------------------------------------------*/
const char* ssid = "ESP32连接的WiFi名称";
const char* password = "WiFi密码";
const char* mqttServer = "华为云MQTT接入地址";
const int   mqttPort = 1883;
//以下3个参数可以由HMACSHA256算法生成,为硬件通过MQTT协议接入华为云IoT平台的鉴权依据
const char* clientId = "";
const char* mqttUser = "";
const char* mqttPassword = "";

WiFiClient espClient; //ESP32WiFi模型定义
PubSubClient client(espClient);

const char* topic_properties_report = "属性上报topic";

//接收到命令后上发的响应topic
char* topic_Commands_Response = "$oc/devices/设备ID/sys/commands/response/request_id=";


/*******************************************************/

PS:

接入地址

        华为云MQTT接入地址以及端口号1883可以在华为云IoTDA的 总览-> 平台接入地址 查看

鉴权信息

        clientId、mqttUser、mqttPassword是设备接入华为云IoT平台时要验证的鉴权信息,可以通过HMACSHA256算法实时在程序中生成,也可以通过产品文档中提供的参数生成工具直接生成(参数生成工具生成的不校验时间戳)

产品文档_设备连接鉴权_华为云

鉴权信息生成工具_华为云

鉴权信息生成工具的使用

        使用刚刚保存的设备id 和 密钥,填入,生成鉴权信息

【教程】ESP32连接华为云IoT平台_第11张图片

【教程】ESP32连接华为云IoT平台_第12张图片

topic

至于属性上报和命令响应等topic定义,在华为云IoTDA-> 产品-> 选择要查看的产品-> topic管理处查看【教程】ESP32连接华为云IoT平台_第13张图片

依据要使用的功能在程序中定义不同的topic,注意{device_id}应该整个替换为设备id,大括号也要替换

4.4.3WiFi配置与MQTT连接初始化

代码

/*
 * 作用:  ESP32的WiFi初始化以及与MQTT服务器的连接
 * 参数:  无
 * 返回值:无
 */
void MQTT_Init()
{
//WiFi网络连接部分
  WiFi.begin(ssid, password); //开启ESP32的WiFi
  while (WiFi.status() != WL_CONNECTED) { //ESP尝试连接到WiFi网络
    delay(3000);
    Serial.println("Connecting to WiFi...");
  }
  Serial.println("Connected to the WiFi network");


//MQTT服务器连接部分
  client.setServer(mqttServer, mqttPort); //设置连接到MQTT服务器的参数

  client.setKeepAlive (60); //设置心跳时间

  while (!client.connected()) { //尝试与MQTT服务器建立连接
    Serial.println("Connecting to MQTT...");
  
    if (client.connect(clientId, mqttUser, mqttPassword )) {
  
      Serial.println("connected");  
  
    } else {
  
      Serial.print("failed with state ");
      Serial.print(client.state());
      delay(6000);
  
    }
  }


//接受平台下发内容的初始化
  client.setCallback(callback); //可以接受任何平台下发的内容

}

4.4.4属性上报

        如果你的产品下定义了属性,那么可以通过ESP32硬件向服务器上报属性。

        比如你的产品上有一LED指示灯,那么在产品中我们可以定义一个服务用于管理灯,该服务下包含一属性,如灯的亮灭状态,灯的颜色。在用户改变灯的亮灭或者颜色等属性后ESP32可以将灯的最新属性数据上报给华为云IoT平台,此即为属性上报。

        在产品-> 选择你的产品-> Topic管理处可以看到属性上报时要public的Topic。

         "{device_id}" 依据你的设备改变。

  • 在上文的代码中,我们已经定义了该属性上报Topic
const char* topic_properties_report = "$oc/devices/Doge1_1/sys/properties/report";

         

属性上报的相关代码

  • 以下是我的一个物联网项目的属性上报代码,读者可以根据自己的需要修改其中的参数

注释里有对代码的详细解释,请仔细阅读注释

/*
 * 作用:  垃圾桶容量上报到MQTT服务器任务
 * 参数:  (int)垃圾桶容量,1代表垃圾桶满了,0代表垃圾桶未满
 * 返回值:无
 * 命名说明:Capacity:容量
 */
void TASK_Capacity_Report(int capacity)
{

//以下部分代码调用了ArduinoJson库将属性上报消息打包为JSON格式
//此部分代码可以通过ArduinoJson库的官方网站直接生成
  StaticJsonBuffer<300> JSONbuffer; //定义静态的JSON缓冲区用于存储JSON消息
  JsonObject& root = JSONbuffer.createObject();
  JsonArray& services = root.createNestedArray("services");
  JsonObject& service_1 = services.createNestedObject();
  JsonObject& properties_1_1 = service_1.createNestedObject("properties");

  service_1["service_id"] = "ash_bin_Service";
  properties_1_1["ash_bin_capacity"] = capacity;

//  root.prettyPrintTo(Serial);//调试用,将JSON打印到串口
 
//以下将生成好的JSON格式消息格式化输出到字符数组中,便于下面通过PubSubClient库发送到服务器
  char JSONmessageBuffer[100];
  root.printTo(JSONmessageBuffer, sizeof(JSONmessageBuffer));
  
  Serial.println("Sending message to MQTT topic..");
  Serial.println(JSONmessageBuffer);


//以下代码将打包好的JSON数据包通过PubSubClient库发送到服务器 
  if (client.publish(topic_properties_report, JSONmessageBuffer) == true) {
    Serial.println("Success sending message");
  } else {
    Serial.println("Error sending message");
  }
 
//由于本函数是放在loop中不断循环执行,所以添加client.loop()进行保持硬件的活跃度
//避免由于长时间未向服务器发送消息而被服务器踢下线
  client.loop();
  Serial.println("-------------");
  
}
  • 以下贴出相关资源网站
​​产品文档_设备接入IoTDA_设备属性上报_华为云  描述了设备属性上报的Json消息格式
ArduinoJson 6_JSON消息代码生成助手 如果你使用的是V6以上的ArduinoJson库版本,请使用这个网站生成代码
ArduinoJson 5_JSON消息代码生成助手 如果你使用的是V5的ArduinoJson库版本,请使用这个网站生成代码

        注意,属性上报可以是设备主动上报消息也可以是接到命令后被动上报。两次主动上报间应有一定的时间间隔,否则会导致服务器接收的消息过多,此时我们可以设置一定时器定时上报,或者当该属性改变时再主动上报给服务器。

4.4.5接收华为云IoT平台下发命令以及命令响应

        如果你的产品模型中定义了命令以及响应的命令参数,那么华为云IoT平台侧可以向设备下发命令,设备接收到命令后必须依据特定的JSON格式向华为云IoT平台侧发送一命令响应,华为云IoT平台侧接收到该命令响应后才视为命令下发成功。

  • 想要接收平台下发的命令或者消息,需要在上文的MQTT_Init()初始化函数中添加一接收消息后触发的回调函数。
//接受平台下发内容的初始化
  client.setCallback(callback); //可以接受任何平台下发的内容

        当接受到平台侧下发给设备的任何消息或者命令时,程序就会调用括号中的回调函数(callback),我们在此回调函数中处理接收到的消息,执行相关操作。

下面贴上我一个项目中的回调函数代码

        读者可以根据自己的需要修改其中的参数。

        注释里有对代码的详细解释,请仔细阅读注释。

  • 该函数主要分为三个部分
  1. 将接收到的命令或者消息在串口展示出来;
  2. 提取出平台发送该命令时Topic中的request_id,并将其与命令响应Topic连接起来,以便进行命令的响应;
  3. 对接收到的命令或者消息进行解析后,执行响应操作。
//监听华为云IoT平台下发指令并处理 
void callback(char *topic, byte *payload, unsigned int length)
{
  char *pstr = topic; //指向topic字符串,提取request_id用

  /*串口打印出收到的平台消息或者命令*/
  Serial.println();
  Serial.println();
  Serial.print("Message arrived [");
  Serial.print(topic);  //将收到消息的topic展示出来
  Serial.print("] ");
  Serial.println();

  payload[length] = '\0'; //在收到的内容后面加上字符串结束符
  char strPayload[255] = {0}; 
  strcpy(strPayload, (const char*)payload);
  Serial.println((char *)payload);  //打印出收到的内容
  Serial.println(strPayload);


  /*request_id解析部分*///后文有详细解释为什么要提取下发命令的request_id
  char arr[100];  //存放request_id
  int flag = 0;
  char *p = arr;
  while(*pstr)  //以'='为标志,提取出request_id
  {
    if(flag) *p ++ = *pstr;
    if(*pstr == '=') flag = 1;
    pstr++;
  }
  *p = '\0';  
  Serial.println(arr);
  // strcat(topic_Commands_Response, arr);
  // topic_Commands_Response.concat(arr);


  /*将命令响应topic与resquest_id结合起来*/
  char topicRes[200] = {0};
  strcat(topicRes, topic_Commands_Response);
  strcat(topicRes, arr);
  Serial.println(topicRes);


  /*payload解析*///这是对接收到的平台下发的消息或者命令进行解析
//解析程序同样可以由ArduinoJson库官方网站的ArduinoJson助手生成
  const size_t capacity_Payload_Receive = JSON_OBJECT_SIZE(3) + JSON_OBJECT_SIZE(5) + 150;
  DynamicJsonBuffer jsonBuffer_Payload(capacity_Payload_Receive);

  JsonObject& root_Payload = jsonBuffer_Payload.parseObject(strPayload);


//以下就是根据不同的命令或者消息进行不同的响应,此部分代码请自行修改
 if (root_Payload.success()){ //判断json解析是否成功
    if(!strcmp(root_Payload["command_name"], "user_order"))  //如果收到的内容是“用户下单”
    {
      JsonObject& paras_Payload = root_Payload["paras"];
      const char* paras_address = paras_Payload["address"]; // "88—902"
      const char* paras_user = paras_Payload["user"]; // "wksgogogo"
      const char* paras_number = paras_Payload["number"]; // "3333"
      const char* paras_day = paras_Payload["day"]; // "2022-07-21"
      const char* paras_time = paras_Payload["time"]; // "12:01"

      Serial.println("__________JSON Received Parse__________");
      Serial.println(paras_address);
      Serial.println(paras_user);
      Serial.println(paras_number);
      Serial.println(paras_day);
      Serial.println(paras_time);

      Info_UserOrder_Structure OrderInfo;
      strcpy(OrderInfo.userName, paras_user);
      strcpy(OrderInfo.address, paras_address);
      strcpy(OrderInfo.orderNum, paras_number);
      strcpy(OrderInfo.day, paras_day);
      strcpy(OrderInfo.time, paras_time);

      //响应函数会在下文贴出
      Command_Response(topicRes, "user_order", SUCCESS);

      OrderInfo_Save(OrderInfo);  //订单信息存储


      
    }


    if(!strcmp(root_Payload["command_name"], "open"))   //如果收到的内容是“开锁”
    {
      const char* paras_user = root_Payload["paras"]["user"]; 
      Serial.println("__________JSON Received Parse__________");
      Serial.println(paras_user);

      EOF_ELock_Unlock(paras_user);

      Command_Response(topicRes, "open", SUCCESS);
    }
  }

命令响应代码

        读者可以根据自己的需要修改其中的参数;

        注释里有对代码的详细解释,请仔细阅读注释;

        此部分代码的原理与属性上报的代码原理基本相同。

void Command_Response(char *topic, char *responseName, uint8_t response_Result)
{
  /*发送命令响应部分*/
    /*构建JSON内容*/
  const size_t capacity = JSON_OBJECT_SIZE(2) + JSON_OBJECT_SIZE(3);
  DynamicJsonBuffer jsonBuffer(capacity);

  JsonObject& root = jsonBuffer.createObject();
  if(response_Result == SUCCESS){
    root["result_code"] = 0;
    JsonObject& paras = root.createNestedObject("paras");
    paras["status"] = 200;
    paras["msg"] = "success";
  }
  else if(response_Result == FAIL){
    root["result_code"] = 1;
    JsonObject& paras = root.createNestedObject("paras");
    paras["status"] = 400;
    paras["msg"] = "fail";
  }
  
  if(!strcmp(responseName, "user_order")){
    root["response_name"] = "user_order";
  }
  else if(!strcmp(responseName, "open")){
    root["response_name"] = "open";
  }
  

  

  root.printTo(Serial); //串口打印出构建好的JSON内容
  Serial.println();


  char JSONmessageBuffer[300];
  root.printTo(JSONmessageBuffer, sizeof(JSONmessageBuffer)); //将构建的JSON消息复制到char数组中
  
  Serial.println("Sending response to HuaWei Cloud..");
  Serial.println(JSONmessageBuffer);
 
  if (client.publish(topic, JSONmessageBuffer) == true) {
    Serial.println("Success sending response command message");
  } else {
    Serial.println("Error sending response command message");
  }
 

  Serial.println("-------------");
}
  • 关于命令响应的一些说明:

华为云产品文档中对于命令下发与命令响应的解释

平台命令下发_设备接入 IoTDA_API参考_设备侧MQTT/MQTTS接口参考_设备命令_华为云

Topic

下行: $oc/devices/{device_id}/sys/commands/request_id={request_id}

上行:$oc/devices/{device_id}/sys/commands/response/request_id={request_id}

  • {request_id}用于唯一标识这次请求。设备侧收到下行请求的topic带该参数时,上行响应的topic需要将该参数值返回给平台。
  • 设备侧订阅带{request_id}结尾的topic时,可以使用通配#,设备侧订阅平台命令下发的topic为:$oc/devices/{device_id}/sys/commands/#

        也就是说,接收华为云IoT平台下发命令时,我们可以不关心Topic中的{request_id}而使用通配符#代替,但是设备接收到命令后必须响应此命令,此时{request_id}不可省略。所以在上文中的callback函数中我们才需要解析出平台下发命令的Topic中的{request_id},并将其接到定义的命令响应Topic中,通过此Topic进行命令的响应。

        下面是宏定义的命令响应Topic,在其后面接上命令下发的{request_id}后才可以用此Topic向平台响应命令。

char* topic_Commands_Response = "$oc/devices/{device_id}/sys/commands/response/request_id=";

        命令响应Topic中的{request_id}与要响应的命令Topic中的{request_id}一致。

        以上便是ESP32与华为云IoT平台的连接过程,希望对你有所帮助。

        笔者道行不深,但努力学习,还请多多指教。

        需要相关代码,请留言评论,笔者会在后续更新。

        如果教程中还有其他不懂的,请评论或者私信我,笔者会尽可能回答。

原创不易,点个赞或者点个关注激励笔者分享更多优质原创内容吧!

开源万岁!

你可能感兴趣的:(华为云,物联网,单片机,嵌入式硬件)