MAVLink协议基础：协议介绍、消息格式与常见类型
MAVLink，全称Micro Air Vehicle Link。说白了，它就是无人机世界里通用的“普通话”。
我第一次接触MAVLink是在2015年，当时调试一架四旋翼，地面站死活收不到心跳包。折腾了两天，最后发现是波特率配错了。嗯，从那以后，我对协议细节再也不敢马虎。
这一节，我们就把MAVLink的底裤扒开看看。你不需要背下所有字节，但得理解它的设计哲学。
1. MAVLink是什么？
MAVLink是一种轻量级的通信协议。专门为微型飞行器设计。它定义了飞控与地面站、机载计算机之间的消息格式。
目前有两个主流版本：v1.0 和 v2.0。v2.0兼容v1.0，但增加了签名机制，安全性更好。我个人建议，新项目直接上v2.0。
核心特点：
- 极轻量：消息头只有8-12字节
- 高可靠性：支持CRC校验
- 跨语言：C/C++、Python、Java都有库
- 可扩展：你可以自定义消息
2. 消息格式：一个字节一个字节拆给你看
MAVLink消息的结构非常规整。我习惯把它想象成一个快递包裹：有信封（帧头）、有内容（载荷）、有防伪标签（校验）。
下面是v2.0的消息帧格式：
| 字节偏移 | 字段名 | 长度(字节) | 说明 |
|---|---|---|---|
| 0 | STX | 1 | 帧起始标志，v2.0固定为0xFD |
| 1 | LEN | 1 | 载荷长度（0-255） |
| 2 | INC_FLAGS | 1 | 不兼容标志位 |
| 3 | CMP_FLAGS | 1 | 兼容标志位 |
| 4 | SEQ | 1 | 序列号，用于丢包检测 |
| 5 | SYS_ID | 1 | 系统ID（飞控通常是1） |
| 6 | COMP_ID | 1 | 组件ID（如IMU、GPS） |
| 7-9 | MSG_ID | 3 | 消息ID（v1.0只有1字节） |
| 10.. | PAYLOAD | LEN | 消息载荷，长度由LEN决定 |
| 最后2 | CRC | 2 | 16位CRC校验 |
小技巧：调试时如果遇到解析错误，先检查STX字节。0xFD是v2.0，0xFE是v1.0。我曾经因为混用版本，浪费了整整一个下午。
3. 常见消息类型：你一定会用到的几个
MAVLink定义了200多种标准消息。但日常开发中，常用的其实就十几个。我把它们分成三类：
3.1 心跳与状态类
- HEARTBEAT (0)：最基础的消息。飞控每秒发一次，告诉地面站“我还活着”。包含系统类型、飞控类型、自定义模式等。
- SYS_STATUS (1)：系统状态。电池电压、传感器健康度、通信丢包率都在这里。
- GPS_RAW_INT (24)：GPS原始数据。经纬度、海拔、地面速度、卫星数量。
3.2 控制与指令类
- COMMAND_LONG (76)：长指令。起飞、降落、返航、设置模式，都通过它下发。
- MANUAL_CONTROL (69)：手动控制。遥控器摇杆值通过它转发给飞控。
- SET_POSITION_TARGET_LOCAL_NED (84)：位置控制。指定目标点坐标，飞控自动飞过去。
3.3 数据流类
- ATTITUDE (30)：姿态数据。横滚、俯仰、偏航角，以及对应的角速度。
- LOCAL_POSITION_NED (32)：本地位置。相对于起飞点的XYZ坐标。
- GLOBAL_POSITION_INT (33)：全局位置。经纬度+相对海拔。
避坑指南：我曾经在项目里直接往飞控发COMMAND_LONG，结果飞控没反应。后来发现是确认机制没处理好。飞控收到指令后会回复COMMAND_ACK，你必须等待这个确认，才能发下一条指令。否则指令会被丢弃。
4. 消息结构图：一张图看懂MAVLink
下面这张SVG图，把MAVLink消息的完整生命周期画出来了。从飞控产生消息，到地面站解析显示，每一步都清楚。
5. 实战：如何抓取并解析一条MAVLink消息
光说不练假把式。我们拿Python的pymavlink库，实际抓一条HEARTBEAT消息看看。
# 安装：pip install pymavlink
from pymavlink import mavutil
# 连接飞控（串口或UDP）
master = mavutil.mavlink_connection('udp:0.0.0.0:14550')
# 等待心跳包
master.wait_heartbeat()
print("收到心跳包！")
# 获取系统信息
msg = master.recv_match(type='HEARTBEAT', blocking=True)
if msg:
print(f"系统类型: {msg.type}")
print(f"飞控类型: {msg.autopilot}")
print(f"模式: {msg.custom_mode}")
print(f"系统状态: {msg.system_status}")运行这段代码，你会看到类似这样的输出：
收到心跳包！
系统类型: 2 (MAV_TYPE_QUADROTOR)
飞控类型: 8 (MAV_AUTOPILOT_PX4)
模式: 4 (自定义模式，对应ArduPilot的STABILIZE)
系统状态: 3 (MAV_STATE_ACTIVE)个人经验：调试时我习惯先打印原始消息的十六进制。用msg.get_msgbuf().hex()就能看到完整的帧数据。对比协议文档，能快速定位封装或解析的问题。
6. 避坑指南：我踩过的三个坑
- 波特率不匹配：飞控默认115200，但有些模块是57600。连不上时先查波特率。
- 消息ID冲突：v1.0的MSG_ID只有1字节，最多255种。v2.0扩展到3字节，但自定义消息时要注意不要占用标准ID。
- CRC计算错误：MAVLink的CRC算法不是标准CRC16。如果你自己实现解析器，一定要用官方提供的CRC表。我当年手算CRC，算出来总是不对，最后老老实实复制了官方的查表代码。