🔥 ข่าวด่วน: weixin /article/details/

MQTT 报文结构与 Python 读取方法详解

引言

在物联网（IoT）领域，MQTT（Message Queuing Telemetry Transport）协议因其轻量级和高效性而备受青睐。本文将详细解析 MQTT 报文的组成结构，并介绍如何使用 Python 读取 MQTT 报文内容。通过具体示例，帮助读者深入理解 MQTT 的工作原理及其在实际项目中的应用。
在这里插入图片描述

MQTT 报文结构

MQTT 报文由三部分组成：固定头部（Fixed Header）、可变头部（Variable Header） 和 有效载荷（Payload）。这种紧凑的设计使其非常适合低带宽、高延迟的网络环境。

1. 固定头部（Fixed Header）

长度：固定头部始终存在，长度为 2 到 4 字节。
组成：
- 控制字段（Control Field）：1 字节。前 4 位表示消息类型（如 CONNECT 为 0x10，PUBLISH 为 0x30），后 4 位为控制标志（如 DUP、QoS、RETAIN）。
- 剩余长度（Remaining Length）：1-4 字节。使用 7 位表示长度，第 8 位为延续标志，用于指示是否需要更多字节。
特点：设计紧凑高效，适合资源受限的设备。

2. 可变头部（Variable Header）

存在性：并非所有消息类型都有可变头部，内容因消息类型而异。
示例：
- CONNECT 消息：包括协议名（如 “MQTT”）、协议版本、连接标志和保持活动时间。
- PUBLISH 消息：包括主题名和包标识符（适用于 QoS 1 或 QoS 2）。

3. 有效载荷（Payload）

存在性：并非所有消息类型都有有效载荷，内容为二进制数据，格式由应用定义。
示例：
- CONNECT 消息：包含客户端 ID。
- PUBLISH 消息：可以是传感器数据、文本消息等。

Python 读取 MQTT 报文

Python 可以通过 Paho MQTT 客户端库轻松连接 MQTT 代理，订阅主题并读取消息内容。

1. 安装 Paho MQTT 库

在终端运行以下命令安装：

pip install paho-mqtt

2. 连接到 MQTT 代理

可以使用公共 MQTT 代理，例如 broker.emqx.io，默认端口为 1883（TCP）。

3. 订阅主题和处理消息

使用 client.subscribe("topic_name") 订阅指定主题。
通过 on_message 回调函数处理接收到的消息，访问 msg.topic（主题）和 msg.payload.decode()（解码后的消息内容）。

具体示例

以下是一个简单的 Python 脚本，用于连接 MQTT 代理、订阅主题并打印接收到的消息：

import paho.mqtt.client as mqtt

def on_connect(client, userdata, flags, rc):
    print("已连接，结果代码：" + str(rc))
    client.subscribe("python/mqtt/test")

def on_message(client, userdata, msg):
    print(f"收到消息：'{msg.payload.decode()}'，来自主题 '{msg.topic}'，QoS {msg.qos}")

client = mqtt.Client()
client.on_connect = on_connect
client.on_message = on_message
client.connect("broker.emqx.io", 1883, 60)
client.loop_forever()