4. 开发环境搭建：Python环境、pymavlink库安装、串口与UDP模拟器配置
说实话，很多初学者在MAVLink上栽跟头，不是因为协议本身多难，而是环境没搭好就开始写代码。我见过太多人花了一周时间调试一个“通信问题”，最后发现是串口权限没开，或者Python版本不对。
这一章，咱们就把地基打牢。你跟着我的步骤走，半小时内就能跑通第一个MAVLink心跳包。
4.1 Python环境准备
我个人习惯用Python 3.8到3.11之间的版本。为什么？因为pymavlink对3.12的支持还在完善中，有些底层C扩展编译会报错。
4.1.1 安装Python
- Windows： 去python.org下载安装包，安装时记得勾选“Add Python to PATH”。
- Linux (Ubuntu/Debian)：
sudo apt install python3 python3-pip python3-venv - macOS： 推荐用Homebrew：
brew install python@3.10
装完后验证一下：
python3 --version
pip3 --version嗯，看到版本号就说明第一步走通了。
4.1.2 创建虚拟环境
我强烈建议每个项目都用独立的虚拟环境。曾经有个同事把所有依赖都装在系统Python里，结果两个项目依赖冲突，折腾了一整天。
# 创建虚拟环境
python3 -m venv mavlink_env
# 激活环境
# Linux/macOS:
source mavlink_env/bin/activate
# Windows:
mavlink_env\Scripts\activate
# 看到终端前面多了 (mavlink_env) 就对了4.2 安装pymavlink库
pymavlink是MAVLink生态里最成熟的Python库。它不光能解析消息，还能生成代码、模拟飞控。说白了，你学会它，就等于拿到了MAVLink世界的万能钥匙。
4.2.1 基础安装
pip install pymavlink如果网络慢，可以用国内镜像：
pip install pymavlink -i https://pypi.tuna.tsinghua.edu.cn/simple4.2.2 验证安装
打开Python交互环境，试试导入：
python3
>>> from pymavlink import mavutil
>>> print(mavutil.__version__)
2.4.37 # 你的版本可能不同，但只要有数字就对了sudo apt install build-essential，macOS装Xcode Command Line Tools。
4.2.3 安装可选依赖
有些高级功能需要额外库。我建议一次性装上：
pip install pymavlink[all]这会安装serial、numpy、future等依赖。如果你只需要基础功能，装核心包就够了。
4.3 串口配置与调试
串口是地面站和飞控最常用的物理连接方式。但串口配置坑很多，我一个个说。
4.3.1 查找串口设备
先把飞控用USB线连到电脑上。然后：
- Linux：
ls /dev/ttyUSB*或ls /dev/ttyACM* - macOS：
ls /dev/cu.usbmodem* - Windows： 打开设备管理器，看“端口(COM和LPT)”
我遇到过最坑的事：Linux上串口设备名是 /dev/ttyACM0，但用户权限不够，打不开。解决办法：
sudo usermod -a -G dialout $USER
# 然后注销重新登录4.3.2 串口参数速查表
| 参数 | 典型值 | 说明 |
|---|---|---|
| 波特率 | 115200 | Pixhawk默认，也有用57600或921600的 |
| 数据位 | 8 | 固定值，不要改 |
| 停止位 | 1 | 固定值 |
| 校验位 | 无 | MAVLink不校验 |
| 流控制 | 无 | 大部分飞控不支持硬件流控 |
4.3.3 测试串口通信
写个简单脚本，看看能不能收到飞控的心跳包：
# test_serial.py
from pymavlink import mavutil
# 创建连接，注意替换成你的串口
master = mavutil.mavlink_connection(
device='/dev/ttyACM0', # Windows用 'COM3'
baud=115200
)
# 等待心跳包（超时10秒）
print("等待飞控心跳...")
msg = master.wait_heartbeat(timeout=10)
if msg:
print(f"收到心跳！系统ID: {msg.get_srcSystem()}")
else:
print("没收到心跳，检查串口和波特率")4.4 UDP模拟器配置
没有真飞控的时候怎么办？用模拟器。我个人最喜欢用UDP模拟，因为它不需要物理线缆，调试起来特别方便。
4.4.1 什么是UDP模拟
说白了，就是让一台电脑同时跑飞控模拟器和地面站，通过UDP端口通信。飞控模拟器监听一个端口，地面站连接另一个端口。
4.4.2 使用mavproxy模拟飞控
mavproxy是MAVLink生态里的瑞士军刀。先安装：
pip install mavproxy然后启动一个模拟飞控：
mavproxy.py --master tcp:127.0.0.1:5760 --out udp:127.0.0.1:14550 --out udp:127.0.0.1:14551这条命令干了三件事：
- 创建一个TCP主端口（5760），供其他工具连接
- 向外广播两个UDP端口（14550和14551），地面站可以连
4.4.3 用Python连接UDP模拟器
# test_udp.py
from pymavlink import mavutil
# 连接UDP端口
master = mavutil.mavlink_connection(
device='udp:127.0.0.1:14550',
source_system=255 # 地面站系统ID
)
print("等待模拟器心跳...")
msg = master.wait_heartbeat(timeout=5)
if msg:
print(f"模拟器在线！类型: {msg.get_type()}")
else:
print("没连上，检查mavproxy是否在运行")4.5 本章知识体系
下面这张图帮你理清整个开发环境的脉络：
4.6 常见问题与避坑指南
- 串口被占用： 有一次我调试了半天，发现是Mission Planner后台占着串口。关掉所有地面站软件再试。
- UDP端口冲突： 14550是MAVLink默认端口，但如果你开了VPN，可能会被占用。换个端口试试，比如14560。
- 防火墙拦截： Windows防火墙默认会拦截UDP广播。要么关防火墙，要么加例外规则。
mavproxy.py --master=udp:0.0.0.0:14550 --out=udp:127.0.0.1:14551 可以同时监听和转发，方便抓包分析。