26-物联网MQTT连云
输入“/”快速插入内容
26-物联网MQTT连云
26-物联网MQTT连云
用户59852025年3月29日修改
ESP-MQTT 是 MQTT 协议客户端的实现，MQTT 是一种基于发布/订阅模式的轻量级消息传输协议。ESP-MQTT 当前支持 MQTT v5.0。
特性
•
支持基于 TCP 的 MQTT、基于 Mbed TLS 的 SSL、基于 WebSocket 的 MQTT 以及基于 WebSocket Secure 的 MQTT
•
通过 URI 简化配置流程
•
多个实例（一个应用程序中有多个客户端）
•
支持订阅、发布、认证、遗嘱消息、保持连接心跳机制以及 3 个服务质量 (QoS) 级别（组成全功能客户端）
应用示例
•
•
•
•
•
•
•
•
•
地址
通过 address 结构体的 uri 字段或者 hostname、transport 以及 port 的组合，可以设置服务器地址。也可以选择设置 path，该字段对 WebSocket 连接而言非常有用。
使用 uri 字段的格式为 scheme://hostname:port/path。
•
当前支持 mqtt、mqtts、ws 和 wss 协议
•
基于 TCP 的 MQTT 示例：
•
mqtt://mqtt.eclipseprojects.io：基于 TCP 的 MQTT，默认端口 1883
•
mqtt://mqtt.eclipseprojects.io:1884：基于 TCP 的 MQTT，端口 1884
•
mqtt://username:password@mqtt.eclipseprojects.io:1884：基于 TCP 的 MQTT， 端口 1884，带有用户名和密码
•
基于 SSL 的 MQTT 示例：
•
mqtts://mqtt.eclipseprojects.io：基于 SSL 的 MQTT，端口 8883
•
mqtts://mqtt.eclipseprojects.io:8884：基于 SSL 的 MQTT，端口 8884
•
基于 WebSocket 的 MQTT 示例：
•
ws://mqtt.eclipseprojects.io:80/mqtt
•
基于 WebSocket Secure 的 MQTT 示例：
•
wss://mqtt.eclipseprojects.io:443/mqtt
•
最简配置：
代码块
const esp_mqtt_client_config_t mqtt_cfg = {
.broker.address.uri = "mqtt://mqtt.eclipseprojects.io",
};
esp_mqtt_client_handle_t client = esp_mqtt_client_init(&mqtt_cfg);
esp_mqtt_client_register_event(client, ESP_EVENT_ANY_ID, mqtt_event_handler, client);
esp_mqtt_client_start(client);
验证
为验证服务器身份，对于使用 TLS 的安全链接，必须设置 verification 结构体。 服务器证书可设置为 PEM 或 DER 格式。如要选择 DER 格式，必须设置等效 certificate_len 字段，否则应在 certificate 字段传入以空字符结尾的 PEM 格式字符串。
代码块
const esp_mqtt_client_config_t mqtt_cfg = {
.broker = {
.address.uri = "mqtts://mqtt.eclipseprojects.io:8883",
.verification.certificate = (const char *)mqtt_eclipse_org_pem_start,
},
};