ESP8266 连接到 MQTT Broker

ESP8266 连接 MQTT 服务器项目实践

最新推荐文章于 2025-10-09 11:59:41 发布

原创

最新推荐文章于 2025-10-09 11:59:41 发布 · 1.9k 阅读

11 ·

CC 4.0 BY-SA版权

本文介绍了如何使用ESP8266通过Arduino IDE连接到EMQ X MQTT Cloud的免费公共服务器，包括所需组件、ESP8266的代码编写和运行测试，展示了ESP8266作为物联网设备发送和接收MQTT消息的能力。

MQTT 是轻量级的、灵活的物联网消息交换和数据传递协议，致力于为 IoT 开发人员实现灵活性与硬件/网络资源的平衡。

ESP8266 提供了⼀套⾼度集成的 Wi-Fi SoC 解决⽅案，其低功耗、紧凑设计和⾼稳定性可以满⾜⽤户的需求。ESP8266 拥有完整的且⾃成体系的 Wi-Fi ⽹络功能，既能够独⽴应⽤，也可以作为从机搭载于其他主机 MCU 运⾏。

在此项目中我们将实现 ESP8266 连接到 EMQ X MQTT Cloud 运营和维护的免费公共 MQTT 服务器，并使用 Arduino IDE 来对 ESP8266 进行编程。 EMQ X Cloud 是由 EMQ 推出的安全的 MQTT 物联网云服务平台，它提供一站式运维代管、独有隔离环境的 MQTT 5.0 接入服务。

所需物联网组件

ESP8266
Arduino IDE
MQTT X: 优雅的跨平台 MQTT 5.0 客户端工具
免费的公共 MQTT 服务器
- Broker: broker.emqx.io
- TCP Port: 1883
- Websocket Port: 8083

ESP8266 Pub/Sub 示意图

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-jE1GGuL1-1609230146697)(https://static.emqx.net/images/8c533fd396ed33ac5a6daa872eced9ba.png)]

ESP8266 代码编写

首先我们将导入 ESP8266WiFi 和 PubSubClient 库，ESP8266WiFi 库能够将 ESP8266 连接到 Wi-Fi 网络，PubSubClient 库能使 ESP8266 连接到 MQTT 服务器发布消息及订阅主题。
```
#include <ESP8266WiFi.h>
#include <PubSubClient.h>
```

设置 Wi-Fi 名称和密码，以及 MQTT 服务器连接地址和端口

// WiFi
const char *ssid = "mousse"; // Enter your WiFi name
const char *password = "qweqweqwe";  // Enter WiFi password

// MQTT Broker
const char *mqtt_broker = "broker.emqx.io";
const char *topic = "esp8266/test";
const char *mqtt_username = "emqx";
const char *mqtt_password = "public";
const int mqtt_port = 1883;

打开一个串行连接，以便于输出程序的结果并且连接到 Wi-Fi 网络

// Set software serial baud to 115200;
Serial.begin(115200);
// connecting to a WiFi network
WiFi.begin(ssid, password);
while (WiFi.status() != WL_CONNECTED) {
     
     
    delay(500);
    Serial.println("Connecting to WiFi..");
}