ESP32 MQTT –使用Arduino IDE发布和订阅

---

功能介绍

该项目展示了如何将MQTT通信协议与ESP32一起使用来发布消息和订阅主题。 例如，我们将BME280传感器的读数发布到Node-RED仪表板，并控制ESP32输出。 我们将使用Arduino IDE对ESP32进行编程。

---

在此示例中，有一个Node-RED应用程序，该应用程序使用MQTT通信协议控制ESP32的输出并从ESP32接收传感器读数。 Node-RED应用程序在Raspberry Pi上运行。

我们将使用安装在同一Raspberry Pi上的Mosquitto代理。 代理负责接收所有消息，过滤消息，确定谁对它们感兴趣并将消息发布到所有订阅的客户端。

下图概述了本教程将要执行的操作。

Node-RED应用程序在主题esp32 / output中发布消息（“ on”或“ off”）。 ESP32已订阅该主题。 因此，它接收到带有“开”或“关”的消息，以打开或关闭LED。
ESP32在esp32 /温度主题上发布温度，在esp32 /湿度主题上发布湿度。 Node-RED应用程序已订阅这些主题。 因此，它接收的温度和湿度读数可以显示在图表或仪表上。

一、介绍BME280传感器模块

BME280传感器模块读取温度，湿度和压力。 由于压力随海拔高度而变化，因此您也可以估算海拔高度。 但是，在本教程中，我们将仅读取温度和湿度。 该传感器模块有多种版本，但我们使用的是下图所示的版本。
传感器可以使用SPI或I2C通信协议进行通信（该传感器的某些模块仅与I2C进行通信，这些模块仅带有四个引脚）。

要使用SPI通信协议，请使用以下引脚：
SCK – this is the SPI Clock pin

• SDO – MISO
• SDI – MOSI
• CS – Chip Select

To use I2C communication protocol, the sensor uses the following pins:

• SCK – SCL pin
• SDI – SDA pin

二、准备Arduino IDE

Arduino IDE有一个附加组件，可让您使用Arduino IDE及其编程语言对ESP32进行编程。 如果您尚未使用Arduino IDE，请按照以下教程之一进行准备，以使其能够与ESP32一起使用。

二、安装PubSubClient库

PubSubClient库提供了一个客户端，用于使用支持MQTT的服务器（基本上允许您的ESP32与Node-RED进行通信）来进行简单的发布/订阅消息传递。

单击此处下载PubSubClient库。 您的下载文件夹中应该有一个.zip文件夹
解压缩.zip文件夹，您应该获得pubsubclient-master文件夹

将文件夹从pubsubclient-master重命名为pubsubclient
将pubsubclient文件夹移至Arduino IDE安装库文件夹
然后，重新打开您的Arduino IDE
该库附带了许多示例草图。 请参阅Arduino IDE软件中的“文件”>“示例”>“ PubSubClient”。

重要提示：PubSubClient与ESP32并不完全兼容，但本教程中提供的示例在我们的测试过程中工作非常可靠。

三、安装BME280库

要获取BME280传感器模块的读数，我们将使用Adafruit_BME280库。 请按照以下步骤在您的Arduino IDE中安装该库：

单击此处下载Adafruit-BME280库。 您的下载文件夹中应该有一个.zip文件夹
解压缩.zip文件夹，您应该会获得Adafruit-BME280-Library-master文件夹
将文件夹从Adafruit-BME280-Library-master重命名为Adafruit_BME280_Library
将Adafruit_BMPE280_Library文件夹移至Arduino IDE安装库文件夹
最后，重新打开您的Arduino IDE

四、安装Adafruit_Sensor库

要使用BME280库，您还需要安装Adafruit_Sensor库。 请按照以下步骤安装该库：

单击此处下载Adafruit_Sensor库。 您的下载文件夹中应该有一个.zip文件夹
解压缩.zip文件夹，您应该获得Adafruit_Sensor-master文件夹
将文件夹从Adafruit_Sensor-master重命名为Adafruit_Sensor
将Adafruit_Sensor文件夹移至Arduino IDE安装库文件夹
最后，重新打开您的Arduino IDE
上载程式码
现在，您可以将以下代码上传到ESP32。 该代码会在需要更改的地方添加注释。 您需要使用自己的SSID，密码和Raspberry Pi IP地址来编辑代码。

/*********
  Rui Santos
  Complete project details at https://randomnerdtutorials.com  
*********/

#include <WiFi.h>
#include <PubSubClient.h>
#include <Wire.h>
#include <Adafruit_BME280.h>
#include <Adafruit_Sensor.h>

// Replace the next variables with your SSID/Password combination
const char* ssid = "REPLACE_WITH_YOUR_SSID";
const char* password = "REPLACE_WITH_YOUR_PASSWORD";

// Add your MQTT Broker IP address, example:
//const char* mqtt_server = "192.168.1.144";
const char* mqtt_server = "YOUR_MQTT_BROKER_IP_ADDRESS";

WiFiClient espClient;
PubSubClient client(espClient);
long lastMsg = 0;
char msg[50];
int value = 0;

//uncomment the following lines if you're using SPI
/*#include <SPI.h>
#define BME_SCK 18
#define BME_MISO 19
#define BME_MOSI 23
#define BME_CS 5*/

Adafruit_BME280 bme; // I2C
//Adafruit_BME280 bme(BME_CS); // hardware SPI
//Adafruit_BME280 bme(BME_CS, BME_MOSI, BME_MISO, BME_SCK); // software SPI
float temperature = 0;
float humidity = 0;

// LED Pin
const int ledPin = 4;

void setup() {
  Serial.begin(115200);
  // default settings
  // (you can also pass in a Wire library object like &Wire2)
  //status = bme.begin();  
  if (!bme.begin(0x76)) {
    Serial.println("Could not find a valid BME280 sensor, check wiring!");
    while (1);
  }
  setup_wifi();
  client.setServer(mqtt_server, 1883);
  client.setCallback(callback);

  pinMode(ledPin, OUTPUT);
}

void setup_wifi() {
  delay(10);
  // We start by connecting to a WiFi network
  Serial.println();
  Serial.print("Connecting to ");
  Serial.println(ssid);

  WiFi.begin(ssid, password);

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println("");
  Serial.println("WiFi connected");
  Serial.println("IP address: ");
  Serial.println(WiFi.localIP());
}

void callback(char* topic, byte* message, unsigned int length) {
  Serial.print("Message arrived on topic: ");
  Serial.print(topic);
  Serial.print(". Message: ");
  String messageTemp;
  
  for (int i = 0; i < length; i++) {
    Serial.print((char)message[i]);
    messageTemp += (char)message[i];
  }
  Serial.println();

  // Feel free to add more if statements to control more GPIOs with MQTT

  // If a message is received on the topic esp32/output, you check if the message is either "on" or "off". 
  // Changes the output state according to the message
  if (String(topic) == "esp32/output") {
    Serial.print("Changing output to ");
    if(messageTemp == "on"){
      Serial.println("on");
      digitalWrite(ledPin, HIGH);
    }
    else if(messageTemp == "off"){
      Serial.println("off");
      digitalWrite(ledPin, LOW);
    }
  }
}

void reconnect() {
  // Loop until we're reconnected
  while (!client.connected()) {
    Serial.print("Attempting MQTT connection...");
    // Attempt to connect
    if (client.connect("ESP8266Client")) {
      Serial.println("connected");
      // Subscribe
      client.subscribe("esp32/output");
    } else {
      Serial.print("failed, rc=");
      Serial.print(client.state());
      Serial.println(" try again in 5 seconds");
      // Wait 5 seconds before retrying
      delay(5000);
    }
  }
}
void loop() {
  if (!client.connected()) {
    reconnect();
  }
  client.loop();

  long now = millis();
  if (now - lastMsg > 5000) {
    lastMsg = now;
    
    // Temperature in Celsius
    temperature = bme.readTemperature();   
    // Uncomment the next line to set temperature in Fahrenheit 
    // (and comment the previous temperature line)
    //temperature = 1.8 * bme.readTemperature() + 32; // Temperature in Fahrenheit
    
    // Convert the value to a char array
    char tempString[8];
    dtostrf(temperature, 1, 2, tempString);
    Serial.print("Temperature: ");
    Serial.println(tempString);
    client.publish("esp32/temperature", tempString);

    humidity = bme.readHumidity();
    
    // Convert the value to a char array
    char humString[8];
    dtostrf(humidity, 1, 2, humString);
    Serial.print("Humidity: ");
    Serial.println(humString);
    client.publish("esp32/humidity", humString);
  }
}

该代码通过MQTT协议发布有关esp32 /温度和esp32 /湿度主题的温度和湿度读数。

ESP32订阅了esp32 / output主题，以接收Node-RED应用程序在该主题上发布的消息。 然后，根据收到的消息，它打开或关闭LED。

订阅MQTT主题
在reconnect（）函数中，您可以订阅MQTT主题。 在这种情况下，ESP32仅订阅esp32 / output：

client.subscribe（“ esp32 / output”）;
在callback（）函数中，ESP32接收已订阅主题的MQTT消息。 根据MQTT主题和消息，它打开或关闭LED：

发布MQTT消息
在loop（）中，每5秒发布一次新的读数：