在 Python 中解析 MAVLink 心跳包（Heartbeat）可以使用 `pymavlink` 库提供的功能。该库支持从接收到的数据流中解码 MAVLink 消息，并提取心跳包中的关键信息，如系统类型、飞行模式、状态等。 ### 解析 MAVLink 心跳包的方法 首先需要建立一个 MAVLink 连接并持续监听数据流。当接收到消息时，可以通过判断其消息类型是否为 `HEARTBEAT` 来识别心跳包。然后调用相应的方法获取解码后的数据结构。 以下是一个完整的示例代码，展示如何使用 Python 解析 MAVLink 心跳包： ```python from pymavlink import mavutil # 创建一个 MAVLink 连接，例如通过 UDP 或串口 master = mavutil.mavlink_connection('udp:127.0.0.1:14550') # 等待第一条心跳以确认连接成功 master.wait_heartbeat() print("Heartbeat received") # 循环接收并解析心跳包 while True: # 接收一条消息 msg = master.recv_match() if not msg: continue # 判断是否为心跳包 if msg.get_type() == 'HEARTBEAT': print(f"Heartbeat received: {msg.to_dict()}") # 提取心跳包中的字段 system_type = msg.type autopilot_type = msg.autopilot base_mode = msg.base_mode custom_mode = msg.custom_mode system_status = msg.system_status # 输出解析结果 print(f"System Type: {system_type}") print(f"Autopilot Type: {autopilot_type}") print(f"Base Mode: {base_mode}") print(f"Custom Mode: {custom_mode}") print(f"System Status: {system_status}") ``` 上述代码中，`recv_match()` 方法用于从数据流中读取消息，`get_type()` 用于判断消息类型，而 `to_dict()` 可将消息内容转换为字典形式以便进一步处理[^3]。 ### 校验机制说明 MAVLink 协议中加入了校验（checksum）功能，以确保通信双方的消息完整性。如果两个设备使用的 MAVLink 版本不同，计算出的校验码会不一致，导致无法正常通信。这种机制通过 `MAVLINK_CRC_EXTRA` 实现，并存储在 `MAVLINK_MESSAGE_CRCS` 中，由生成代码时自动包含在头文件中[^1]。 ### 消息结构与协议支持 MAVLink 的传输基本单位是消息帧，长度范围为 8 到 263 字节不等。心跳包作为其中一种标准消息类型，广泛应用于无人机与地面站之间的通信中。Pixhawk/APM 系统均采用 MAVLink 协议进行飞控数据链路传输，并提供了良好的原生支持[^3]。 ##