1. MAVSDK概览与环境搭建
大家好，我是你们的无人机系统工程师老张。今天咱们开始第一课——MAVSDK的概览与环境搭建。说实话，我接触MAVSDK也有五六年了，从最早的C++版本一路跟到现在，踩过的坑确实不少。但别担心，我会把这些经验都分享给你。
1.1 MAVSDK是什么？
MAVSDK，全称是MAVLink Software Development Kit。说白了，它就是一套让你能跟无人机“对话”的编程工具包。你想想看，无人机飞控（比如PX4）有自己的语言——MAVLink协议。但直接写MAVLink报文太痛苦了，就像让你用汇编语言写网页一样。
MAVSDK帮你封装好了。你只需要调用几个函数，就能完成起飞、降落、航线飞行这些操作。我刚开始做无人机开发时，就是靠它快速搭建了第一个原型系统。
核心要点：MAVSDK = 无人机控制的“高级API”，让你用几行代码就能指挥无人机飞行。
1.2 核心架构：C++/Python/Java
MAVSDK支持三种主流语言：C++、Python、Java。我个人最常用的是Python，因为开发效率高，调试也方便。但如果你做嵌入式系统，C++版本会更合适。
| 语言 | 适用场景 | 性能 | 学习曲线 |
|---|---|---|---|
| C++ | 嵌入式、高性能系统 | 高 | 陡峭 |
| Python | 快速原型、教学、测试 | 中等 | 平缓 |
| Java | Android、企业级应用 | 中等 | 中等 |
嗯，这里要注意：虽然语言不同，但底层逻辑完全一样。你学会了Python版本，切换到C++也就是语法上的变化。
1.3 PX4与MAVSDK的关系
这个问题我经常被问到。PX4是飞控固件，它运行在无人机的大脑（飞控板）上。而MAVSDK是运行在地面站电脑上的SDK。它们通过MAVLink协议通信。
打个比方：PX4是飞行员，MAVSDK是地面指挥中心。指挥中心通过无线电（MAVLink）给飞行员下达指令。我曾经在项目中遇到过通信延迟导致指令丢失的情况，后来发现是波特率设置不对。这个坑后面会详细讲。
我的经验：PX4和MAVSDK的版本要匹配。比如PX4 v1.12对应MAVSDK v0.30+，版本不对会出各种奇怪问题。
1.4 开发环境搭建（Ubuntu + Python）
我个人习惯用Ubuntu 20.04 LTS，稳定且社区支持好。下面一步步来：
- 安装Python 3.8+：Ubuntu 20.04自带Python 3.8，但建议升级到3.10
- 创建虚拟环境：
python3 -m venv mavsdk_env - 激活环境：
source mavsdk_env/bin/activate - 安装MAVSDK：
pip install mavsdk
我曾经在安装时遇到依赖冲突，后来发现是pip版本太旧。建议先升级pip：pip install --upgrade pip
避坑指南：不要用sudo pip安装！否则会污染系统Python环境。我刚开始就吃过这个亏，搞得系统Python都崩了。
1.5 Hello World示例
好了，环境搭好了，咱们写个最简单的程序——让无人机连接并打印版本信息。
import asyncio
from mavsdk import System
async def run():
drone = System()
await drone.connect(system_address="udp://:14540")
print("等待无人机连接...")
async for state in drone.core.connection_state():
if state.is_connected:
print(f"已连接！无人机UUID: {state.uuid}")
break
# 获取版本信息
version = await drone.info.get_version()
print(f"固件版本: {version.firmware_version}")
print(f"MAVSDK版本: {version.mavsdk_version}")
if __name__ == "__main__":
asyncio.run(run())这段代码做了三件事：连接无人机、等待连接成功、打印版本信息。你想想看，如果没有MAVSDK，你得手动解析MAVLink报文，至少得写50行代码。
运行方式：先启动PX4 SITL模拟器，再运行这个脚本。连接地址默认是udp://:14540，如果你用真实无人机，改成串口地址就行。
嗯，这里要注意：第一次运行可能会报错，说缺少asyncio模块。别慌，这是Python 3.7以下版本的问题。升级到3.8+就好了。
知识体系总览
下面这张图展示了本章的核心逻辑：
这张图把本章内容串起来了。从MAVSDK出发，分三条线：核心架构、PX4关系、环境搭建，最后汇聚到Hello World实战。你跟着这个脉络走，思路会非常清晰。
好了，第一课就到这里。记住：环境搭建是基础中的基础，别嫌麻烦。我当年为了配环境折腾了一整天，但一旦跑通第一个Hello World，那种成就感是无与伦比的。
如果你在搭建过程中遇到问题，欢迎交流。咱们下节课见！