pymavlink实战：从串口到UDP的MAVLink通信指南

1. 环境准备与工具安装

第一次接触MAVLink通信时，我被各种专业术语和配置参数搞得晕头转向。后来发现只要准备好这几个基础工具，就能快速搭建起通信环境。我的工作电脑是Windows 10系统，Python版本选择了3.11，这个版本对pymavlink的兼容性最好。建议使用Anaconda创建独立环境，避免与其他项目产生依赖冲突。

安装pymavlink时踩过版本兼容的坑，最新版2.4.40最稳定。直接用pip安装就行：

pip install pymavlink==2.4.40

串口调试需要两个神器：Virtual Serial Port Driver 6.9创建虚拟串口对，sscom5.13.1作为调试助手。虚拟串口工具建议设置COM1和COM2为一对虚拟端口，这样pymavlink连COM1发送数据，调试助手连COM2就能立即看到效果。记得以管理员身份运行这些工具，否则可能出现权限问题。

2. 串口通信实战

2.1 建立串口连接

配置串口连接时，source_system和source_component这两个参数特别重要。它们相当于设备的身份证号，我一般设置source_system=1表示飞控系统，source_component=2代表机载计算机。连接代码很简单：

from pymavlink import mavutil connect = mavutil.mavlink_connection('COM1', baud=57600, source_system=1, source_component=2)

实际测试发现，波特率57600最稳定。如果连接失败，先检查设备管理器里的COM口是否被占用。我遇到过Python程序崩溃后串口未释放的情况，重启电脑才解决。

2.2 发送MAVLink消息

发送任务列表请求消息是个很好的入门示例。注意target_system要匹配接收端的系统ID，这里用connect自带的属性值：

target_system = connect.target_system target_component = connect.target_component msg = connect.mav.mission_request_list_encode( target_system, target_component) for _ in range(10): connect.mav.send(msg) time.sleep(1) # 避免消息轰炸

在调试助手看到十六进制报文时，开头总是"FE"表示帧头，接着是载荷长度。我习惯用Wireshark抓包对比，确保数据格式正确。

3. UDP网络通信实战

3.1 UDP连接配置

UDP比串口更方便调试，推荐先用本地回环地址(127.0.0.1)测试。pymavlink支持三种UDP模式：

• udpout：单播发送
• udpbcast：广播发送
• udpin：接收模式

# 发送端配置 sender = mavutil.mavlink_connection('udpout:127.0.0.1:8000', source_system=1, source_component=2) # 接收端配置 receiver = mavutil.mavlink_connection('udpin:0.0.0.0:8000', source_system=1, source_component=1)

特别注意：接收端的IP设为0.0.0.0表示监听所有网卡。我在树莓派上测试时，因为没设置这个参数导致收不到数据。

3.2 心跳包维护

MAVLink通信需要保持心跳，否则连接会被认为已断开。心跳包至少要包含设备类型和自动驾驶仪类型：

sender.mav.heartbeat_send( mavutil.mavlink.MAV_TYPE_ONBOARD_CONTROLLER, mavutil.mavlink.MAV_AUTOPILOT_INVALID, 0, 0, 0)

实测发现心跳间隔最好控制在1-2秒。有次我设成5秒，地面站频繁报警，后来查文档才知道默认超时时间是3秒。

4. 消息解析实战

4.1 通用解析方法

recv_match()是最常用的接收方法，blocking=True会阻塞直到收到消息：

while True: msg = receiver.recv_match(blocking=True) print(f"收到{msg.get_type()}消息") print(f"字段列表: {msg.get_fieldnames()}")

对于GLOBAL_POSITION_INT这类导航消息，关键字段包括：

• lat/lon：经纬度(度*1e7)
• alt：海拔高度(mm)
• relative_alt：相对高度(mm)
• vx/vy/vz：三轴速度(cm/s)

4.2 姿态数据解析

ATTITUDE消息包含飞行器三轴姿态角，但要注意单位转换：

if msg.get_type() == 'ATTITUDE': roll = msg.roll * 57.2958 # 弧度转角度 pitch = msg.pitch * 57.2958 yaw = msg.yaw * 57.2958 print(f"横滚:{roll:.1f}° 俯仰:{pitch:.1f}° 偏航:{yaw:.1f}°")

有次测试发现角度值异常，原来是忘了单位转换。MAVLink文档明确说明姿态角使用弧度制，这点特别容易忽略。

4.3 原始报文解析

遇到未知报文时，先用十六进制分析。例如收到：

FE 1C 0A 01 01 21 0B 45 01 00 00 00 00 00 00 00...

解析步骤：

1. 第二个字节0x1C=28，表示载荷长度
2. 第六个字节0x21=33，是消息ID
3. 查MAVLink官方文档，ID33对应GLOBAL_POSITION_INT

在项目中我整理了个消息ID对照表，遇到问题直接查表比翻文档快得多。