ESP32的MQTT使用

最新推荐文章于 2025-04-01 12:55:58 发布
最新推荐文章于 2025-04-01 12:55:58 发布
阅读量2.2w 收藏 98
点赞数 8
分类专栏： ESP32 文章标签： ESP32
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/chen244798611/article/details/97972236
版权

一、ESP32的MQTT函数介绍

1、esp_mqtt_client_handle_t esp_mqtt_client_init(const esp_mqtt_client_config_t *config)

函数描述：根据配置创建MQTT客户端句柄

参数esp_mqtt_client_config_t的结构体如下

typedef struct {
    mqtt_event_callback_t event_handle; / *！<处理MQTT事件作为传统模式的回调* /
    esp_event_loop_handle_t event_loop_handle; / *！<MQTT事件循环库的句柄* /
    const char * host; / *！<MQTT服务器域（ipv4 as string）* /
    const char * uri; / *！<完整的MQTT代理URI * /
    uint32_t port; / *！<MQTT服务器端口* /
    const char * client_id; / *！<默认客户端ID是``ESP32_％CHIPID％``其中％CHIPID％是十六进制格式的MAC地址的最后3个字节* /
    const char * username; / *！<MQTT用户名* /
    const char *密码; / *！<MQTT密码* /
    const char * lwt_topic; / *！<LWT（遗嘱和遗嘱）消息主题（默认为NULL）* /
    const char * lwt_msg; / *！<LWT消息（默认为NULL）* /
    int lwt_qos; / *！<LWT消息qos * /
    int lwt_retain; / *！<LWT保留消息标志* /
    int lwt_msg_len; / *！<LWT消息长度* /
    int disable_clean_session; / *！<mqtt clean session，默认clean_session为true * /
    int keepalive; / *！<mqtt keepalive，默认为120秒* /
    bool disable_auto_reconnect; / *！<此mqtt客户端将重新连接到服务器（当出错/断开连接时）。设置disable_auto_reconnect = true以禁用* /
    void * user_context; / *！<将用户上下文传递给此选项，然后可以在``event-> user_context`` * /中接收该上下文
    int task_prio; / *！<MQTT任务优先级，默认为5，可以在``make menuconfig``中更改* /
    int task_stack; / *！<MQTT任务堆栈大小，默认为6144字节，可以在``make menuconfig``中更改* /
    int buffer_size; / *！<MQTT发送/接收缓冲区的大小，默认为1024 * /
    const char * cert_pem; / *！<用于服务器验证的PEM格式的证书数据指针（使用SSL），默认为NULL，不需要验证服务器* /
    const char * client_cert_pem; / *！<指向用于SSL相互身份验证的PEM格式的证书数据的指针，默认为NULL，如果不需要相互身份验证，则不需要。如果它不是NULL，则还必须提供`client_key_pem`。 * /
    const char * client_key_pem; / *！<指向用于SSL相互身份验证的PEM格式的私钥数据的指针，默认为NULL，如果不需要相互身份验证，则不需要。如果它不是NULL，则还必须提供`client_cert_pem`。 * /
    esp_mqtt_transport_t transport; / *！<覆盖URI传输* /
    int refresh_connection_after_ms; / *！<刷新此值后的连接（以毫秒为单位）* /
esp_mqtt_client_config_t;

返回值：MQTT句柄 错误的时候返回NULL

使用举例：

    esp_mqtt_client_config_t mqtt_cfg = {
        .host = "192.168.43.95", //MQTT 地址
		.port = 1883,    //MQTT端口
		.username = "admin",//用户名字
		.password = "public",//密码
    };

    esp_mqtt_client_handle_t client = esp_mqtt_client_init(&mqtt_cfg);

2、sp_err_t esp_mqtt_client_start(esp_mqtt_client_handle_t client)

函数描述：启动MQTT客户端

参数：创建的MQTT句柄

返回值：ESP_OK表示成功ESP_ERR_无效_ARG错误初始化ESP_FERT其他错误

3、esp_err_t esp_mqtt_client_stop(esp_mqtt_client_handle_t client)

函数描述：停止MQTT客户端

参数：创建的MQTT句柄

4、int esp_mqtt_client_subscribe(esp_mqtt_client_handle_t client, const char *topic, int qos)

函数描述：订阅主题

参数：A、esp_mqtt_client_handle_t client     创建的MQTT句柄

         B、char *topic  订阅的主题

         C、Qos级别 0 、1、 2

返回值：成功时订阅消息返回Message_id- 失败返回-1

5、int esp_mqtt_client_unsubscribe(esp_mqtt_client_handle_t client, const char *topic)

函数描述：取消订阅的主题

参数：A、esp_mqtt_client_handle_t client     创建的MQTT句柄

         B、B、char *topic  订阅的主题

返回值：成功时订阅消息返回Message_id- 失败返回-1

6、int esp_mqtt_client_publish(esp_mqtt_client_handle_t client, const char *topic, const char *data, int len, int qos, int retain)

函数描述：往代理发布消息

参数：A、esp_mqtt_client_handle_t client     创建的MQTT句柄

          B、char *topic  发布的主题

         C、 const char *data  发布的数据

        D、int len    数据长度，如果设置为0，则从发布的数据长度

        E、Qos级别

       F、retain  当我们使用MQTT客户端发布消息（PUBLISH）时，如果将RETAIN标志位设置为true，那么MQTT服务器会将最近收到的一条RETAIN标志位为true的消息保存在服务器端

7、esp_err_t esp_mqtt_client_register_event(esp_mqtt_client_handle_t client, esp_mqtt_event_id_t event, esp_event_handler_t event_handler, void* event_handler_arg)

函数描述：注册MQTT事件

参数：A、esp_mqtt_client_handle_t client     创建的MQTT句柄

         B、esp_mqtt_event_id_t event     注册任何事件id的处理程序

       C、esp_event_handler_t event_handler  回调函数

       D、void* event_handler_arg  处理程序上下文

 

二、实验内容

1、初始化wifi，并连接wifi

2、初始化MQTT,连接成功发布、订阅主题

 

1、初始化wifi，并连接wifi

static EventGroupHandle_t wifi_event_group;

/* The event group allows multiple bits for each event,
   but we only care about one event - are we connected
   to the AP with an IP? */
const int CONNECTED_BIT = BIT0;
//wifi 事件
static esp_err_t event_handler(void *ctx, system_event_t *event)
{
    switch (event->event_id) {
        case SYSTEM_EVENT_STA_START:
            esp_wifi_connect();
            break;
        case SYSTEM_EVENT_STA_GOT_IP:
        	//Mqtt_init();
            xEventGroupSetBits(wifi_event_group, CONNECTED_BIT);
            break;
        case SYSTEM_EVENT_STA_DISCONNECTED:
            /* This is a workaround as ESP32 WiFi libs don't currently
               auto-reassociate. */
            esp_wifi_connect();
            xEventGroupClearBits(wifi_event_group, CONNECTED_BIT);
            break;
        default:
            break;
    }
    return ESP_OK;
}
//初始化wifi
void app_wifi_initialise(void)
{
    tcpip_adapter_init();
    wifi_event_group = xEventGroupCreate();
    ESP_ERROR_CHECK(esp_event_loop_init(event_handler, NULL));
    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    ESP_ERROR_CHECK(esp_wifi_init(&cfg));
    ESP_ERROR_CHECK(esp_wifi_set_storage(WIFI_STORAGE_RAM));
    wifi_config_t wifi_config = {
        .sta = {
            .ssid = "tplingk",
            .password = "12345678",
        },
    };
    ESP_LOGI(TAG, "Setting WiFi configuration SSID %s...", wifi_config.sta.ssid);
    ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));
    ESP_ERROR_CHECK(esp_wifi_set_config(ESP_IF_WIFI_STA, &wifi_config));
    ESP_ERROR_CHECK(esp_wifi_start());
}
//等待wifi成功连接
void app_wifi_wait_connected()
{
    xEventGroupWaitBits(wifi_event_group, CONNECTED_BIT, false, true, portMAX_DELAY);
}

上面就是初始化wifi ,并且连接wifi.在wifi连接成功里面设置事件标志

2、初始化MQTT,连接成功发布、订阅主题

static esp_err_t mqtt_event_handler_cb(esp_mqtt_event_handle_t event)
{
    esp_mqtt_client_handle_t client = event->client;
    int msg_id;
    // your_context_t *context = event->context;
    switch (event->event_id) {
        case MQTT_EVENT_CONNECTED://连接MQTT成功
            ESP_LOGI(TAG, "MQTT_EVENT_CONNECTED");
            msg_id = esp_mqtt_client_publish(client, "/World", "data_3", 0, 1, 0);
            ESP_LOGI(TAG, "sent publish successful, msg_id=%d", msg_id);

            msg_id = esp_mqtt_client_subscribe(client, "/topic0", 0);
            ESP_LOGI(TAG, "sent subscribe successful, msg_id=%d", msg_id);

            msg_id = esp_mqtt_client_subscribe(client, "/topic1", 1);
            ESP_LOGI(TAG, "sent subscribe successful, msg_id=%d", msg_id);
            msg_id = esp_mqtt_client_subscribe(client, "/topic1", 2);
            ESP_LOGI(TAG, "sent subscribe successful, msg_id=%d", msg_id);
            //msg_id = esp_mqtt_client_unsubscribe(client, "/topic/qos1");
            //ESP_LOGI(TAG, "sent unsubscribe successful, msg_id=%d", msg_id);
            break;
        case MQTT_EVENT_DISCONNECTED://断开MQTT
            ESP_LOGI(TAG, "MQTT_EVENT_DISCONNECTED");
            break;

        case MQTT_EVENT_SUBSCRIBED://订阅成功
        	printf("_---------订阅--------\n");
            ESP_LOGI(TAG, "MQTT_EVENT_SUBSCRIBED, msg_id=%d", event->msg_id);
            msg_id = esp_mqtt_client_publish(client, "/World", "data", 0, 0, 0);
            ESP_LOGI(TAG, "sent publish successful, msg_id=%d", msg_id);
            break;
        case MQTT_EVENT_UNSUBSCRIBED://取消订阅
            ESP_LOGI(TAG, "MQTT_EVENT_UNSUBSCRIBED, msg_id=%d", event->msg_id);
            break;
        case MQTT_EVENT_PUBLISHED://发布成功
        	printf("_--------发布----------\n");
            ESP_LOGI(TAG, "MQTT_EVENT_PUBLISHED, msg_id=%d", event->msg_id);
            break;
        case MQTT_EVENT_DATA://数据接收
            ESP_LOGI(TAG, "MQTT_EVENT_DATA");
            printf("主题长度:%d 数据长度:%d\n",event->topic_len,event->data_len);

            printf("TOPIC=%.*s\r\n", event->topic_len, event->topic);
            printf("DATA=%.*s\r\n", event->data_len, event->data);
            break;
        case MQTT_EVENT_ERROR://MQTT错误
            ESP_LOGI(TAG, "MQTT_EVENT_ERROR");
            break;
        default:
            ESP_LOGI(TAG, "Other event id:%d", event->event_id);
            break;
    }
    return ESP_OK;
}

static void mqtt_event_handler(void *handler_args, esp_event_base_t base, int32_t event_id, void *event_data) {
    ESP_LOGD(TAG, "Event dispatched from event loop base=%s, event_id=%d", base, event_id);
    mqtt_event_handler_cb(event_data);
}

static void mqtt_app_start(void)
{
    printf("\n______________等待wifi连接____________\n");
    app_wifi_wait_connected();
    vTaskDelay(5000 / portTICK_PERIOD_MS);
    printf("\n______________wifi连接成功____________\n");
    esp_mqtt_client_config_t mqtt_cfg = {
        .host = "192.168.43.95",//MQTT 地址
		.port = 1883,   //MQTT端口
		.username = "admin",//用户名
		.password = "public",//密码
    };

    esp_mqtt_client_handle_t client = esp_mqtt_client_init(&mqtt_cfg);//初始化MQTT
    esp_mqtt_client_register_event(client, ESP_EVENT_ANY_ID, mqtt_event_handler, client);//注册事件
    esp_mqtt_client_start(client);//启动mQTT
    while(1){

    	vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

在连接成功MQTT之后，发布一个消息，订阅三个消息如下

            msg_id = esp_mqtt_client_publish(client, "/World", "data_3", 0, 1, 0)；

            msg_id = esp_mqtt_client_subscribe(client, "/topic0", 0);

            msg_id = esp_mqtt_client_subscribe(client, "/topic1", 1);
            msg_id = esp_mqtt_client_subscribe(client, "/topic1", 2);
 

三、实验结果

连接的是本地搭建的MQTT服务器emqttd,网上很多教程。

连接成功之后就可以在里面看到，ESP32_050F44就是连接成功的设备

 

发布和订阅的主题

 

发布和订阅消息

串口打印的数据

 

esp32 mqtt通信
超级博客
05-30 1305
我们学习了如何使用ESP32连接WiFi，并利用MQTT技术将消息发送到EMQX网站上。具体包括：WiFi模块实现网络连接；接着学习MQTT协议的基本原理和应用，最后通过编写代码将数据发送到EMQX网站。这些技能有助于物联网开发和远程通信。
ESP32实现(MQTT Client)连接物联网平台（ThingsCloud ）
mftang的博客
03-13 4804
本文主要介绍使用ESP32硬件平台，搭建一个基于MQTT协议的物联网客户端，使其连接到ThingsCloud平台上，并上报user数据到ThingsCloud平台，还实现订阅平台信息，并鞥正确的识别和解析该信息。还介绍ThingsCloud平台提供的可视面板模块的使用方法。并将ESP32上报的数据，通过可视化工具呈现出来。
【ESP32】ESP32与MQTT通信：实现传感器数据监测与设备控制
hmywillstronger的博客
03-30 1395
MQTT(Message Queuing Telemetry Transport)是一种轻量级的发布/订阅消息传输协议，专为资源受限设备和低带宽、高延迟网络设计。轻量级：最小化网络带宽占用，适合IoT设备发布/订阅模式：解耦消息发送者和接收者可靠性：提供三种服务质量等级(QoS)简单实现：易于集成到各种设备和平台。
esp32 使用 mqtt 通信
最新发布
黑光技术
04-01 952
这里我配置了简单的用户名密码鉴权，给每个账户分配用户名和密码，客户端使用相应的用户名和密码就可以连接上来了。手机端也有一个 mqtt 的客户端 app，测试的话可以直接使用：IoT OnOff，我是 iphone，直接在服务市场就可以下载使用了。这里有个比较奇异的操作，就是如果要把管理端通过 nginx 代理出来，需要把 emqx 的前端代码独立拷贝出来，配置为一个独立站点。我拷贝到了这里：/hdata/www/emqx_dashboard/，然后再配置一个 web 站点出来，nginx 的配置如下。
ESP32中MQTT通讯
cat_eat_fish
02-28 3827
代码测试ESP32中MQTT通讯
ESP32MQTT
bytechip的博客
12-16 3030
这个实验的功能演示 ESP32MQTT 的使用方法。 这个实验的代码为工程“4_10_wifi_MQTT”目录。 4.10.1. 实验内容 学习 ESP32 注册移动 onenet MQTT 服务器 学习 ESP32 通过 MQTT 上传数据到移动 onenet 学习通过移动 onenet 下发数据控制开发板 4.10.2. MQTT 介绍 MQTT(消息队列遥测传输)是 ISO 标准(ISO/IEC PRF 20922)下基于发布/订阅范式的消息协议。它工作在 TCP/IP 协议族上，是为硬件性能低下的远
【ESP32】阿里云物联网平台连接及数据互传（MQTT）
weixin_41920367的博客
07-26 7812
1.创建示例项目ota_example_mqtt：VSCODE中->“查看”->”命令面板“->输入：Show Examples projects->选择Use current ESP-IDF(C:\Espressif\frameworks\esp-idf-v5.1)->弹出示例ESP-IDF Examples，选择protocols->mqtt->tcp->Create project using example tcp->选择示例保存的路径。11.点击“监控”按键，可以看到连接成功的信息。
ESP32 IDF开发-ESP32 MQTT_TCP例程
07-23
在本教程中，我们将深入探讨ESP32如何使用IDF进行MQTT和TCP/IP的集成，以及如何构建一个简单的MQTT客户端应用。 首先，ESP-IDF是Espressif Systems为ESP32微控制器提供的开源开发框架。它包含了构建、编译和调试ESP...
esp-mqtt:ESP32 mqtt组件
04-28
ESP32 MQTT库 特征 基于： : 支持基于TCP的MQTT，具有mbedtls的SSL，基于Websocket的MQTT，基于Websocket Secure的MQTT 易于设置URI 多个实例（一个应用程序中有多个客户端） 支持订阅，发布，身份验证，将消息...
esp32-mqtt-formatstring:使用MQTT与ESP32通讯。 谨防
04-05
ESP32 MQTT格式字符串 本示例连接到使用idf.py menuconfig （使用mqtt tcp传输）选择的代理URI，并作为示例进行订阅/取消订阅并发送有关特定主题的消息。 （请注意，公共经纪人由社区维护，因此可能并不总是可用，...
esp32通过mqtt协议连接阿里云
09-23
ESP32通过MQTT协议连接阿里云是一种常见的物联网(IoT)应用场景，它允许ESP32微控制器与阿里云物联网平台进行实时数据交互。在这个过程中，ESP32首先需要连接到WiFi网络，然后通过MQTT（Message Queuing Telemetry ...
ESP32-mqtt-room:基于ESP32的状态检测节点，可与Home Assistant mqtt_room组件一起使用以进行本地化设备状态检测
05-25
请参阅的漂亮文档 ESP32-mqtt-room 基于ESP32的状态检测节点，与 一起使用，用于本地化设备状态检测。 发行说明 在查看。 学分 没有许多的帮助，这个项目是不可能的 入门 提供了完整的说明列表。 家庭助理配置 请参阅有关的 可追踪设备 信标硬件 Android设备 iOS设备 其他设备 开发任务 去做 请参阅标记为增强的未解决问题列表。 您还可以通过查看开发任务项目板来查看开发任务的状态。 完全的 实现基本的BLE数据包发现 实施iBeacon数据包解析 README.md中的安装说明 解决看门狗问题 最大距离限制（四舍五入到小数点后两位） 扫描间隔设置 实施无线（OTA）更新 通过PlatformIO构建和上传
ESP32 MQTT服务通信传输DHT11温湿度数据及控制LED
ouening的博客
06-20 4892
关于如何在Windows下设置mqtt服务器请移步上一篇博文：python MQTT服务通信 环境准备： mosqutto服务端程序，需要进行一些配置，重启服务，默认服务端口为1883 mqttx客户端程序，方便订阅和发布信息：https://github.com/emqx/MQTTX/releases Arduino通过包管理器安装PubSubClient esp32连接的网络和运行mosqutto服务程序的电脑处在同一个网段 arduino代码 /********* @author: Wenqi
ESP32实现（MQTT Client）连接物联网平台（EMQX）
mftang的博客
03-19 5780
本文主要介绍使用ESP32实现MQTT Client, 连接至使用EMQX自建服务器上，使用MQTT.fx模拟客户端发布和订阅来自ESP32实现MQTT Client的消息，同时ESP32实现MQTT Client也订阅来自MQTT.fx的消息。还使用MQTT.fx发布消息的方式来触发ESP32控制外围设备。
ESP32通过MQTT协议连接阿里云物联网平台（1）
m0_57863338的博客
06-16 3293
因为自己要做一个关于ESP32的项目，自己想把这个过程记录下来并且分享一下自己在这个过程中如何进行操作，以及我自己遇到的一些问题是如何解决的。首先，我们需要将阿里云物联网平台配置好，(这里配置阿里云物联网平台可以参考，但MQTT协议部分讲的不是很详细，我对这部分进行进一步解析)
【物联网】ESP32使用MQTT协议上传数据到onenet物联网平台
bsy1111的博客
07-15 1907
为什么使用MQTT协议？MQTT是一个基于客户端-服务器的消息发布/订阅传输协议。MQTT协议是轻量、简单、开放和易于实现的，这些特点使它适用范围非常广泛。但是作为小白初学者来说，写MQTT的Arduino代码是真的不懂，反正我感觉一点儿都不简单，相较于http协议的post请求，代码多了好多！代码实现的是从“34”GPIO口读取模拟信号值，并上传到onenet平台。
ESP32使用MQTT协议通讯（EMQX）
清山博客
08-04 4655
前面完成了ESP32+MicroPython环境的搭建现在想实现以下功能：1.通过手机或电脑，远程给ESP32发送相关指令。2.ESP32接到指令后，做出相应的高低电平输出。这样就相当于可以远程控制ESP32了。查询资料了解到，目前物联网差不多都使用MQTT协议来进行设备间通信。所以从协议开始学习。MQTT(消息队列遥测传输)是ISO 标准(ISO/IEC PRF 20922)下基于发布/订阅范式的消息协议。
ESP32连接MQTT服务器
weixin_61470035的博客
03-23 1044
RETAIN：设置Retain=1，服务器会将该消息持久化存储，并在后续有新订阅者订阅该主题时，将消息重新发送给新订阅者；设置Retain=0，消息仅实时传递给当前在线的订阅者，不存储（仅在PUBLISH消息中有效）；DUP：为0时表示PUBLISH报文是第1次发送，为1时表示PUBLISH报文是重发报文；QoS1（至少发送一次，未收到PUBACK报文时，可能重复发送）；QoS2（只发送一次，并且保证报文有发送到）；QoS0（最多发送一次）；
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

做了不一定能实现但不做一定不会实现

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值