# ESP-MQTT

[English]

## 概述

ESP-MQTT 是 MQTT 协议客户端的实现，属于轻量级发布/订阅消息协议。ESP-MQTT 现已支持 MQTT v5.0。

自 ESP-IDF v6.0 起，`ESP-MQTT` 组件已从 ESP-IDF 中移至独立仓库：

- esp-mqtt 组件仓库

如需在项目中添加 ESP-MQTT 组件，请运行 `idf.py add-dependency espressif/mqtt`。

## 托管文档

文档链接如下：

- esp-mqtt 文档

## 应用示例

ESP-IDF 中提供了两个参考示例：

- 基于 TLS 的 MQTT 通信（证书包模式）：`examples/protocols/mqtt`

  - 默认使用 ESP-IDF 证书包验证代理服务器。

  - 默认代理地址指向 `mqtts://test.mosquitto.org:8886` （采用 Let's Encrypt 证书链）。

  - 替代方案可配置 Mosquitto CA 证书并改用 `mqtts://test.mosquitto.org:8883` 地址。

- 基于 TLS 的 MQTT 5.0 通信（证书包模式）：`examples/protocols/mqtt5`

  - 使用 MQTT v5.0 协议，通过 TLS 传输并借助证书包完成验证。

  - 默认代理地址指向 `mqtts://test.mosquitto.org:8886`。

如需更多传输模式（TCP、WS/WSS、双向认证等）的示例，请参考 espressif/mqtt 组件仓库。

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。