mirror of
https://github.com/espressif/esp-idf.git
synced 2026-04-29 03:44:59 +00:00
Shen Mengjing
41 lines
1.5 KiB
ReStructuredText
41 lines
1.5 KiB
ReStructuredText
ESP-MQTT
|
|
========
|
|
|
|
:link_to_translation:`en:[English]`
|
|
|
|
概述
|
|
----
|
|
|
|
ESP-MQTT 是 `MQTT <https://mqtt.org/>`__ 协议客户端的实现，属于轻量级发布/订阅消息协议。ESP-MQTT 现已支持 `MQTT v5.0 <https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html>`__。
|
|
|
|
自 ESP-IDF v6.0 起，``ESP-MQTT`` 组件已从 ESP-IDF 中移至独立仓库：
|
|
|
|
* `esp-mqtt 组件仓库 <https://github.com/espressif/esp-mqtt>`__
|
|
|
|
如需在项目中添加 ESP-MQTT 组件，请运行 ``idf.py add-dependency espressif/mqtt``。
|
|
|
|
托管文档
|
|
--------
|
|
|
|
文档链接如下：
|
|
|
|
* `esp-mqtt 文档 <https://docs.espressif.com/projects/esp-mqtt/zh_CN/latest/>`__
|
|
|
|
应用示例
|
|
--------
|
|
|
|
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 组件仓库 <https://components.espressif.com/components/espressif/mqtt>`__。
|