ESP8266 保留消息应用

在本节课里，我们将向您讲解如何使用ESP8266发布保留消息。和以往课程一样，我们还将使用PubSubClient库来实现这一功能。

在开始本节课以前请确保您的电脑已经成功安装了MQTTfx软件。另外我们还将使用PubSubClient库。您可以通过以下链接获取此库。

• 官网地址：https://pubsubclient.knolleary.net/
• GitHub：https://github.com/knolleary/pubsubclient/
• 百度网盘下载：https://pan.baidu.com/s/12MHGbdfiOdwOGip5RMSSEQ 提取码: sizy

以下是使用ESP8266实现保留消息发布的示例程序，关于本程序的使用方法以及说明信息，请收看本文首部的视频教程。

本程序旨在演示如何使用PubSubClient库使用ESP8266向MQTT服务器发布保留信息。

此程序在a_publish_ranye_url程序基础上修改。重点修改内容是publish函数添加了

第三个参数，用于设置发布信息是否是保留信息(retained msg)

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

#include <ESP8266WiFi.h>

#include <PubSubClient.h>

 

// 设置wifi接入信息(请根据您的WiFi信息进行修改)

const char* ssid = "taichi-maker";

const char* password = "12345678";

const char* mqttServer = "test.ranye-iot.net";

 

// 如以上MQTT服务器无法正常连接，请前往以下页面寻找解决方案

// http://www.taichi-maker.com/public-mqtt-broker/

 

WiFiClient wifiClient;

PubSubClient mqttClient(wifiClient);

 

void setup() {

  Serial.begin(9600);

 

  //设置ESP8266工作模式为无线终端模式

  WiFi.mode(WIFI_STA);

  

  // 连接WiFi

  connectWifi();

  

  // 设置MQTT服务器和端口号

  mqttClient.setServer(mqttServer, 1883);

 

  // 连接MQTT服务器

  connectMQTTServer();

  

  if (mqttClient.connected()) { // 如果开发板成功连接服务器

    pubRetMQTTmsg();               // 发布信息  

  }

}

 

void loop() {

  mqttClient.loop();          // 保持心跳

}

 

void connectMQTTServer(){

  // 根据ESP8266的MAC地址生成客户端ID（避免与其它ESP8266的客户端ID重名）

  String clientId = "esp8266-" + WiFi.macAddress();

 

  // 连接MQTT服务器

  if (mqttClient.connect(clientId.c_str())) {

    Serial.println("MQTT Server Connected.");

    Serial.println("Server Address: ");

    Serial.println(mqttServer);

    Serial.println("ClientId:");

    Serial.println(clientId);

  } else {

    Serial.print("MQTT Server Connect Failed. Client State:");

    Serial.println(mqttClient.state());

    delay(3000);

  }  

}

 

// 发布信息

void pubRetMQTTmsg(){

  // 建立发布主题。主题名称以Taichi-Maker-为前缀，后面添加设备的MAC地址。

  // 这么做是为确保不同用户进行MQTT信息发布时，ESP8266客户端名称各不相同，

  String topicString = "Taichi-Maker-Ret-" + WiFi.macAddress();

  char publishTopic[topicString.length() + 1];  

  strcpy(publishTopic, topicString.c_str());

 

  // 建立即将发布的保留消息。消息内容为"Retained Msg"。

  String messageString = "Retained Msg";

  char publishMsg[messageString.length() + 1];  

  strcpy(publishMsg, messageString.c_str());

  

  // 实现ESP8266向主题发布retained信息

  // 以下publish函数第三个参数用于设置保留信息（retained message)

  if(mqttClient.publish(publishTopic, publishMsg, true)){

    Serial.println("Publish Topic:");Serial.println(publishTopic);

    Serial.println("Publish Retained message:");Serial.println(publishMsg);    

  } else {

    Serial.println("Message Publish Failed.");

  }

}

 

// ESP8266连接wifi

void connectWifi(){

 

  WiFi.begin(ssid, password);


  //等待WiFi连接,成功连接后输出成功信息

  while (WiFi.status() != WL_CONNECTED) {

    delay(1000);

    Serial.print(".");

  }

  Serial.println("");

  Serial.println("WiFi Connected!");  

  Serial.println("");

}