esp32 基于 ESP-IDF 框架的 mqtt 客户端的实现

于 2025-05-21 06:00:00 发布
阅读量691 收藏 9
点赞数 15
分类专栏： esp32 文章标签： esp32 mqtt
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_46158019/article/details/148008436
版权

基于 ESP-IDF 5.2.5 实现 ESP32-S3 的 MQTT 客户端的使用。

一、项目配置准备

1. 启用 MQTT 组件

在 ESP-IDF 中，MQTT 功能由 esp-mqtt 组件提供。需通过 menuconfig 启用相关功能：

idf.py menuconfig
  • 导航至 Component config → ESP-MQTT，确保以下选项启用：
    • Enable MQTT over TCP（默认启用，TCP 连接）
    • 若需 TLS 加密（MQTT over SSL），启用 Enable MQTT over SSL，并根据需要配置证书（见下文）。

二、关键配置参数说明

以下是 MQTT 客户端常用配置参数（代码中通过 esp_mqtt_client_config_t 结构体设置）：

参数说明
uriMQTT 服务器地址（如 mqtt://broker.emqx.io:1883 或 mqtts://...）
client_id客户端 ID（可选，默认生成随机值）
username/passwordMQTT 服务器认证的用户名和密码（若服务器需要）
keepalive心跳间隔（秒，默认 120）
disable_clean_session是否保留会话（0 为清除会话，1 为保留）
lwt_topic/lwt_msg遗嘱消息主题和内容（客户端异常断开时发送）
transport传输协议（MQTT_TRANSPORT_OVER_TCP/MQTT_TRANSPORT_OVER_SSL）

三、测试代码

代码如下：

#include "esp_log.h"
#include "esp_wifi.h"
#include "esp_event.h"
#include "mqtt_client.h"
#include "nvs_flash.h"
#include "string.h"

static const char* TAG = "MQTT_Demo";


#define WIFI_SSID "esp32"
#define WIFI_PASSWORD "12345678"

#define MQTT_BROKER_URL "mqtt://broker-cn.emqx.io"     //MQTT连接地址
#define MQTT_USERNAME "user"                     //MQTT用户名
#define MQTT_PASSWORD "12345678"                  //MQTT密码


#define MQTT_PUBLIC_TOPIC      "/topic1"       //测试用的,推送消息主题
#define MQTT_SUBSCRIBE_TOPIC    "/topic2"      //测试用的,需要订阅的主题


// MQTT 客户端句柄（全局变量，方便回调函数访问）
static esp_mqtt_client_handle_t mqtt_client = NULL;

// WiFi 连接事件处理
static void wifi_event_handler(void* arg, esp_event_base_t event_base,int32_t event_id, void* event_data) 
{
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) 
    {
        esp_wifi_connect();  // WiFi 启动后尝试连接
    } 
    else if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_DISCONNECTED) 
    {
        ESP_LOGW(TAG, "WiFi 断开，尝试重连...");
        esp_wifi_connect();  // 断开后自动重连
    } 
    else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) 
    {
        ip_event_got_ip_t* event = (ip_event_got_ip_t*)event_data;
        ESP_LOGI(TAG, "获取 IP: " IPSTR, IP2STR(&event->ip_info.ip));
        // WiFi 连接成功后启动 MQTT
        esp_mqtt_client_start(mqtt_client);
    }
}

// MQTT 事件处理（核心回调函数）
static void mqtt_event_handler(void* handler_args, esp_event_base_t base,int32_t event_id, void* event_data) 
{
    esp_mqtt_event_handle_t event = event_data;
    switch ((esp_mqtt_event_id_t)event_id) 
    {
        case MQTT_EVENT_CONNECTED:
            ESP_LOGI(TAG, "MQTT 连接成功！");
            // 连接成功后订阅主题（示例：订阅 MQTT_SUBSCRIBE_TOPIC）
            int msg_id = esp_mqtt_client_subscribe(mqtt_client, MQTT_SUBSCRIBE_TOPIC, 1);  // QoS=1
            ESP_LOGI(TAG, "订阅主题，消息 ID: %d", msg_id);
            break;

        case MQTT_EVENT_DISCONNECTED:
            ESP_LOGW(TAG, "MQTT 连接断开");
            break;

        case MQTT_EVENT_SUBSCRIBED:
            ESP_LOGI(TAG, "订阅成功，消息 ID: %d", event->msg_id);
            break;

        case MQTT_EVENT_UNSUBSCRIBED:
            ESP_LOGI(TAG, "取消订阅，消息 ID: %d", event->msg_id);
            break;

        case MQTT_EVENT_PUBLISHED:
            ESP_LOGI(TAG, "消息发布成功，消息 ID: %d", event->msg_id);
            break;

        case MQTT_EVENT_DATA: 
            // 收到订阅的消息（打印主题和内容）
            ESP_LOGI(TAG, "收到消息:");
            ESP_LOGI(TAG, "主题: %.*s", event->topic_len, event->topic);
            ESP_LOGI(TAG, "内容: %.*s", event->data_len, event->data);
            break;

        case MQTT_EVENT_ERROR:
            ESP_LOGE(TAG, "MQTT 错误！");
            if (event->error_handle->error_type == MQTT_ERROR_TYPE_TCP_TRANSPORT) 
            {
                ESP_LOGE(TAG, "TCP 传输错误: 0x%x", event->error_handle->esp_tls_last_esp_err);
            }
            break;

        default:
            ESP_LOGI(TAG, "其他 MQTT 事件 ID: %d", event->event_id);
            break;
    }
}

// 初始化 WiFi
static void wifi_init(void) 
{
    ESP_ERROR_CHECK(esp_netif_init());  // 初始化网络接口
    ESP_ERROR_CHECK(esp_event_loop_create_default());  // 创建默认事件循环
    esp_netif_create_default_wifi_sta();  // 创建默认 STA 接口

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));

    // 注册 WiFi 和 IP 事件回调
    ESP_ERROR_CHECK(esp_event_handler_instance_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &wifi_event_handler, NULL, NULL));
    ESP_ERROR_CHECK(esp_event_handler_instance_register(IP_EVENT, IP_EVENT_STA_GOT_IP,&wifi_event_handler, NULL, NULL));

    // 配置 WiFi 参数（从 menuconfig 获取）
    wifi_config_t wifi_config = {
        .sta = {
            .ssid = WIFI_SSID,
            .password = WIFI_PASSWORD,
            .threshold.authmode = WIFI_AUTH_WPA2_PSK,  // 默认 WPA2
        },
    };
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));
    ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config));
    ESP_ERROR_CHECK(esp_wifi_start());
}
/*
client_id ,  // 可选，若不设置会自动生成随机 ID
keepalive = 60,                      // 心跳间隔 60 秒
disable_clean_session = 0,           // 清除会话（断开后不保留状态）
lwt_topic = "topic/last_will",       // 遗嘱主题（可选）
lwt_msg = "ESP32-S3 断开连接",        // 遗嘱内容（可选）
lwt_qos = 1,                         // 遗嘱消息 QoS
lwt_retain = 1,                      // 遗嘱消息保留标志

*/
// 初始化 MQTT 客户端
static void mqtt_init(void) 
{
    // 配置 MQTT 参数

    esp_mqtt_client_config_t mqtt_cfg = 
    {
        .broker.address.uri = MQTT_BROKER_URL,
        .broker.address.port = 1883,
        .credentials.username=MQTT_USERNAME,
        .credentials.authentication.password=MQTT_PASSWORD,
        .credentials.client_id="ESP32-S3_MQTT_Client",  // 可选，若不设置会自动生成随机 ID
        .session.keepalive=120,// 心跳间隔 60 秒
        .session.last_will.qos = 0, 遗嘱消息 QoS
    };

    // 创建 MQTT 客户端实例
    mqtt_client = esp_mqtt_client_init(&mqtt_cfg);
    // 注册 MQTT 事件回调
    ESP_ERROR_CHECK(esp_mqtt_client_register_event(mqtt_client, ESP_EVENT_ANY_ID,mqtt_event_handler, NULL));
}

// 定时发布消息任务（示例：每 5 秒发布一次）
static void publish_task(void* arg) 
{
    int msg_count = 0;
    while (1) 
    {
        vTaskDelay(pdMS_TO_TICKS(5000));  // 5 秒间隔
        if (mqtt_client == NULL) 
        {
            continue;
        }
        // 构造消息内容（JSON 格式示例）
        char payload[64];
        snprintf(payload, sizeof(payload), "{\"count\": %d, \"device\": \"ESP32-S3\"}", msg_count++);
        // 发布消息到 MQTT_PUBLIC_TOPIC，QoS=1，不保留
        int msg_id = esp_mqtt_client_publish(mqtt_client, MQTT_PUBLIC_TOPIC, payload, 0, 1, 0);
        ESP_LOGI(TAG, "发布消息，内容: %s，消息 ID: %d", payload, msg_id);
    }
}

void app_main(void) 
{
    // 初始化 NVS（用于存储 WiFi 配置等）
    ESP_ERROR_CHECK(nvs_flash_init());

    // 初始化 WiFi 和 MQTT
    wifi_init();
    mqtt_init();

    // 启动发布任务
    xTaskCreate(publish_task, "publish_task", 4096, NULL, 5, NULL);
}

代码功能：

  • WiFi 连接（自动重连）
  • MQTT 客户端初始化（支持 TCP/TLS）
  • 连接状态回调（连接成功/断开）
  • 消息订阅与发布（订阅 topic/test，每 5 秒发布一次消息）

在这里插入图片描述

四、代码关键功能说明

  1. WiFi 连接：

    • 通过 wifi_init() 初始化 WiFi，自动处理连接和重连。

  2. MQTT 客户端初始化：

    • mqtt_init() 配置 MQTT 服务器地址、认证信息等参数。
    • 支持遗嘱消息（LWT），客户端异常断开时通知服务器。

  3. 事件处理：

    • mqtt_event_handler 处理连接、断开、订阅、消息接收等事件。
    • 连接成功后自动订阅 topic/test 主题。

  4. 消息发布：

    • publish_task 任务每 5 秒向 topic/test 主题发布 JSON 格式消息。

五、TLS 加密连接（可选）

若需 MQTT over SSL（如连接 mqtts://broker.emqx.io:8883），需：

  1. 在 menuconfig 中启用 Component config → ESP-MQTT → Enable MQTT over SSL。
  2. 提供服务器证书（CA 证书），可通过以下方式嵌入代码：
    • 将证书文件（如 broker_ca.pem）放在项目的 main 目录下。
    • 在代码中添加证书内容（或通过 idf.py menuconfig 加载）：
      // 在 mqtt_cfg 中添加证书配置
static const char* broker_ca_pem = 
    "-----BEGIN CERTIFICATE-----\n"
    "MIICUTCCAfugAwIBAgIBADANBgkqhkiG9w0BAQQFADBXMQswCQYDVQQGEwJDTjEL\n"
    "...（证书内容）...\n"
    "-----END CERTIFICATE-----\n";

esp_mqtt_client_config_t mqtt_cfg = {
    .uri = "mqtts://broker.emqx.io:8883",
    .cert_pem = broker_ca_pem,  // CA 证书
    // 其他参数...
};

六、测试步骤

  1. 配置参数：
    设置：

    • WiFi SSID： WiFi 名称
    • WiFi Password： WiFi 密码
    • MQTT Broker URL：测试用 MQTT 服务器（如 mqtt://broker.emqx.io:1883）

  2. 编译烧录：

    idf.py set-target esp32s3  # 确保目标为 ESP32-S3
idf.py build flash monitor

  3. 验证日志：

    • 观察串口日志，应看到 WiFi 连接成功、MQTT 连接成功、订阅成功的提示。
    • 每 5 秒会打印“发布消息”日志，同时可通过 MQTT 客户端工具（如 MQTTX）订阅 topic/test 主题，验证消息接收。

注意事项

  • MQTT 服务器选择：推荐使用公共测试服务器（如 broker.emqx.io），无需认证。
  • QoS 级别：示例中使用 QoS=1（确保消息至少送达一次），根据需求调整（0：最多一次，2：仅一次）。
  • 重连机制：WiFi 或 MQTT 断开时会自动重连（依赖 esp_mqtt_client 内置逻辑）。
  • 资源限制：ESP32-S3 的 RAM 有限，避免发布过大的消息（单条消息建议不超过 1KB）。

参考：
https://github.com/espressif/esp-idf/blob/master/examples/protocols/mqtt/tcp/main/app_main.c

https://docs.espressif.com/projects/esp-idf/zh_CN/v5.2.5/esp32/api-reference/index.html

ESP32-IDF开发之旅 基础篇① 走入ESP32-IDF
单片机菜鸟哥的博客
11-27 2322
欢迎大家来到ESP32-IDF的世界，从现在开始，博主将以自己的学习历程来讲述是如何入门学习ESP32-IDF，分享自己的学习经验。
ESP32-IDF开发实例-网络编程-MQTT客户端
视觉与物联智能
07-18 920
MQTT客户端 ESP32是一系列高度集成的、专为移动设备、可穿戴电子产品设计的物联网模块，其集成了天线开关、RF balun、功率放大器、低接收噪声放大器，滤波器、电源管理模块等，可以独立运行应用，也可以通过SPI/SDIO或I2C/UART接口为其他设备提供WiFi和蓝牙功能。 本次实例将使用ESP32-IDF的MQTT客户端实现数据请求。 1、硬件准备 NodeMCU ESP32-S V3.0开发板一块 带有WiFi功能的路由器 2、软件准备 vscode ESP-IDF开发包及vscode扩
ESP32 ESP-IDF MQTT
晨之清风
12-09 4496
陈拓 2021/12/08-2021/12/08 1. 简介 官方文档 https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/protocols/mqtt.html 官方例程 https://gitee.com/EspressifSystems/esp-idf/tree/master/examples/protocols/mqtt/tcp ESP-MQTT sample application 此示例连接
初识ESP32 与 ESP32 -IDF
zhouv_的博客
03-03 5241
介绍ESP及ESP-IDF
MQTT入门（基于ESP-IDF）
qq_40773212的博客
08-27 1134
MQTT(Message Queuing Telemetry Transport, 消息队列遥测传输协议)，是一种基于发布/订阅(publish/subscribe)模式的"轻量级"通讯协议，该协议构建于TCP/IP协议上，由IBM在1999年发布。MQTT最大优点在于，可以以极少的代码和有限的带宽，为远程连接设备提过实时可靠的消息服务，作为一种低开销、低带宽占用的即时通讯协议，使其在物联网、小型设备、移动应用等方面有较广泛的应用MQTT是一个基于客户端-服务器的消息发布/订阅传输协议。
ESP-IDF MQTT Broker 项目教程
gitblog_00729的博客
09-01 1008
ESP-IDF MQTT Broker 项目教程 esp-idf-mqtt-brokerMQTT Broker for esp-idf项目地址:https://gitcode.com/gh_mirrors/es/esp-idf-mqtt-broker 项目介绍 ESP-IDF MQTT Broker 是一个基于 ESP-IDF 框架的 MQTT 代理服务器实现。该项目允许用户在 ESP32 设备...
ESP32使用ESP-IDF连接MQTT服务器踩坑
weixin_63894002的博客
06-14 1205
代码使用的是ESP-IDF套件里examples/protocols/mqtt/tcp例程，由于我用的是EMQX搭建的本地服务器，所以用ESP32连接服务器时，要保证ESP32和电脑在同一个局域网内。最后发现由于是电脑防火墙阻止了ESP32的连接，关闭防火墙后，问题完美解决。要想以后打开防火墙后能够正常访问，可以在防火墙高级设置里面新建入站和出战规则。连接过程中一直出现以下错误。
使用EMQX搭建本地MQTT服务器 + ESP32基于ESP-IDF框架连接本地MQTT服务器
Nibudao的博客
07-11 743
访问选择Serverless版本，然后点击右下角，下图中红框内的内容就是要我们在ESP32中设置的服务器网址MQTT1，密码12345678，当然这个可以自定义的，不一定要和这个一模一样。
ESP32-IDF MQTT连接aws亚马逊云
爱出名的狗腿子
05-27 2633
分享使用ESP32 IDF开发方案连接AWS MQTT服务器的简单应用了，重点需要注意的是初始化mqtt_cfg结构体的时候对应的参数配置，以及需要增加client_id参数才能连接成功，原本的示例 demo 里面没有此项内容，这可能是大家连接不上的一个重要原因。创作不易，转载请注明出处！ESP32 AT指令连接AWS亚马逊云（点击跳转！！！物联网ESP32专栏（点击跳转！！！爱出名的狗腿子（点击跳转）爱出名的狗腿子（点击跳转）
esp-idf-mqtt-broker：esp-idf的MQTT代理
02-04
esp-idf-mqtt-broker esp-idf的MQTT代理。 该项目使用。 我从分叉。 欢迎您的叉子。 在此项目目录中，创建一个组件目录。 在components目录中，克隆猫鼬：git clone 在新的Mongoose目录中，创建一个component....
esp-idf-espnow-gateway:使用esp-idf的esp-now和MQTT之间的网关
03-21
使用esp-idf的esp-now和MQTT之间的网关。 我的灵感来自于。 ESP-NOW可以与ESP8266 / 8285一起使用，但我们不能同时使用WiFi。该项目将ESP-NOW接收的数据传输到MQTT。 电池寿命 ESP8266 / 8285 +电池+ ESP-NOW + ...
ESP32 IDF开发-ESP32 MQTT_TCP例程
07-23
ESP32 MQTT_TCP例程是基于ESP-IDF框架进行物联网通信的一种实现方式，它利用MQTT（Message Queuing Telemetry Transport）协议与MQTT服务器进行数据交换。在本教程中，我们将深入探讨ESP32如何使用IDF进行MQTT和TCP/...
ESP-IDF MQTT连接腾讯云平台
06-11
本实例展示 VSCODE+ESP-IDF MQTT连接腾讯云平台通讯交互数据，实现通过网络远程控制灯开关，原生esp-idf mqtt实现，无需第三方sdk。只需要根据实际情况替换三元件、主题地址和配置wifi ssid和wifi密码即可。
支持pyramid2.x的kotti web代码
05-21
Kotti 是一个基于 Pyramid 框架的 Python 内容管理系统（CMS），适合用来搭建中小型网站、文档库、企业展示平台、知识库等需要灵活内容结构和权限模型的项目。它本身更像一个可以二次开发的 CMS 框架，比 WordPress、Drupal 这类“一装就用”的系统更倾向于开发者定制和扩展。 这是支持pyramid2.x版本的kotti！ tar -xzvf kotti1.0.tar.gz 解压缩 进入目录执行 pip install -e . 来安装， 然后执行pserve app.ini 启动。 用浏览器浏览127.0.0.1:5000 即可浏览。 用户名admin ，口令qwerty
cmd-bat-批处理-脚本-hello world.zip
最新发布
05-21
cmd-bat-批处理-脚本-hello world.zip
知识付费系统自动采集V3.0 跳转不卡顿+搭建教程
05-21
知识付费系统自动采集V3.0 跳转不卡顿+搭建教程，不和外面的一样跳转卡顿，这个跳转不卡顿，支持三级分销。
基于Matlab实现图像形状纹理颜色特征提取
05-21
在Matlab环境下，对图像进行特征提取时，主要涵盖形状、纹理以及颜色这三大关键特征。其中，对于纹理特征的提取，采用灰度梯度共生矩阵这一方法来实现。通过灰度梯度共生矩阵，可以有效地捕捉图像中像素灰度值之间在不同方向和距离上的相互关系，进而量化地反映出图像的纹理特性，为后续的图像分析、分类等任务提供重要的纹理信息依据。
实证数据-2010-2023年上市公司-管理层情感语调数据-社科经管.rar
05-21
该数据集为2010-2023年中国A股上市公司管理层情感语调的年度面板数据，覆盖45,320条样本，数据源自年报及半年报的"管理层讨论与分析"部分。通过构建中文金融情感词典（融合《知网情感分析用词典》与L&M金融词汇表），采用文本分析方法计算情感语调指标，包括：正面/负面词汇数量、文本相似度、情感语调1（(积极词-消极词)/总词数）和情感语调2（(积极词-消极词)/(积极词+消极词)）。同时包含盈利预测偏差、审计意见类型等衍生指标，可用于研究信息披露质量、市场反应及代理问题。该数据复刻了《管理世界》《财经研究》等期刊的变量构建方法，被应用于分析语调操纵对债券市场的影响，学术常用度与稀缺度较高。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值