4. 消息定义与XML规范：消息集、枚举、字段、数组与位掩码

好，咱们进入第四章。这一章我打算把MAVLink的“骨架”给你拆开看看——也就是消息定义和XML规范。说白了，就是MAVLink怎么用一套XML文件，把无人机和地面站之间要传的所有数据都给规定死。

我记得刚接触MAVLink那会儿，第一反应是：“这玩意儿怎么还有自己的编程语言？”后来看明白了，它就是用XML当“元语言”，把通信协议的定义工作给标准化了。你想想看，如果没有这套规范，每个飞控厂家都自己定义报文格式，那地面站得适配多少种协议？

4.1 消息集（Message Set）的组织方式

MAVLink的消息集，说白了就是一个XML文件里定义的所有消息的集合。每个XML文件对应一个“方言”（dialect），比如common.xml是通用消息集，ardupilotmega.xml是ArduPilot的扩展。

消息集的组织有几个关键点：

• 版本声明：每个XML文件开头都要声明MAVLink版本号
• 包含关系：方言文件可以include其他XML文件，实现复用
• 消息ID唯一性：同一个方言内，消息ID不能重复
• 命名空间：每个方言有自己的命名空间，避免冲突

我见过不少新手在自定义消息时，随手写个ID就往上怼，结果跟官方消息冲突了。嗯，这里要注意：0-255是MAVLink 1.0的保留区间，256以上才是MAVLink 2.0的扩展区间。我建议你自定义消息时，从500以后开始分配ID，这样基本不会撞车。

4.2 枚举类型（Enum）的定义与使用

枚举在MAVLink里用得特别多。你想啊，无人机有几十种状态、模式、错误码，总不能每次都传个字符串吧？枚举就是干这个的——把整数跟有意义的名称绑定起来。

看个例子：

<enum name="MAV_MODE_FLAG" bitmask="true">
  <description>Mode flags for MAVLink 2.0</description>
  <entry value="128" name="MAV_MODE_FLAG_SAFETY_ARMED">
    <description>System is armed and safe to use</description>
  </entry>
  <entry value="64" name="MAV_MODE_FLAG_MANUAL_INPUT_ENABLED">
    <description>Manual input is enabled</description>
  </entry>
</enum>

这里有个细节：bitmask="true"表示这个枚举是按位掩码用的，不是互斥的。也就是说，你可以同时设置多个标志位。我在做飞控地面站的时候，就靠这个来解析飞行模式——一个字节就能表示好几种状态的组合。

4.3 消息字段（Message Fields）的定义规则

消息字段是MAVLink消息的基本单元。每个字段都有类型、名称、描述，还可以指定单位、缩放因子等元信息。

字段类型分几类：

类型	说明	字节数	典型用途
uint8_t	无符号8位整数	1	小范围计数、枚举值
int16_t	有符号16位整数	2	小范围传感器数据
float	32位浮点数	4	GPS坐标、姿态角
char[ ]	字符串数组	可变	文本信息、状态描述

定义字段时，我建议你遵循几个原则：

• 能用小类型就别用大的：比如高度用float就够了，别用double，浪费带宽
• 字段顺序有讲究：MAVLink 1.0要求字段按字节对齐，把相同大小的字段放一起能减少填充字节
• 描述要写清楚：别偷懒，<description>里写明白这个字段的单位和取值范围

4.4 数组（Array）的定义与内存布局

MAVLink里的数组，说白了就是同一类型数据的连续排列。最常见的用法是字符串和传感器数据批量传输。

数组定义示例：

<message id="24" name="GPS_RAW_INT">
  <field type="int32_t" name="lat" units="degE7">Latitude</field>
  <field type="int32_t" name="lon" units="degE7">Longitude</field>
  <field type="int32_t" name="alt" units="mm">Altitude</field>
  <field type="uint8_t" name="satellites_visible">Number of visible satellites</field>
</message>

数组在内存里是连续存放的。比如uint8_t data[32]，就是32个字节挨着排。你想想看，如果传一个32字节的数组，那整个消息体就是32字节加上其他字段。MAVLink 2.0支持可变长度数组，但1.0只支持固定长度。

我建议你：

• 能用固定长度就别用变长，解析起来简单
• 数组长度尽量是2的幂次方，对齐效果好
• 字符串数组记得留一个字节给结尾的'\0'

4.5 位掩码（Bitmask）的高效编码技巧

位掩码是MAVLink里最优雅的设计之一。你想啊，一个字节8个位，每个位代表一个开关状态，那一个字节就能表示8种状态。比传8个布尔值省了7个字节。

位掩码的定义方式：

<enum name="MAV_SYS_STATUS_SENSOR" bitmask="true">
  <entry value="1" name="MAV_SYS_STATUS_SENSOR_3D_GYRO">
    <description>3D gyro</description>
  </entry>
  <entry value="2" name="MAV_SYS_STATUS_SENSOR_3D_ACCEL">
    <description>3D accelerometer</description>
  </entry>
  <entry value="4" name="MAV_SYS_STATUS_SENSOR_3D_MAG">
    <description>3D magnetometer</description>
  </entry>
  <entry value="8" name="MAV_SYS_STATUS_SENSOR_ABSOLUTE_PRESSURE">
    <description>Absolute pressure</description>
  </entry>
</enum>

看到没？每个entry的value都是2的幂次方。这样组合起来，一个uint16_t就能表示16个传感器的状态。我在做飞控健康监测时，就用这个来上报传感器状态——地面站收到一个16位的整数，就能知道哪些传感器正常、哪些故障。

4.6 XML规范的整体结构

最后，咱们把整个XML规范的结构串起来。下面这张图展示了MAVLink XML文件的完整骨架：

从这张图你能看出来，MAVLink的XML规范其实就三大块：版本声明、枚举定义、消息定义。枚举里又分普通枚举和位掩码枚举，消息定义里包含消息ID和字段列表。字段可以是基本类型，也可以是数组。

我个人觉得，MAVLink这套XML规范最聪明的地方在于：它把协议定义和代码生成分开了。你只需要写XML，工具链自动生成C/C++/Python的解析代码。这样既保证了跨平台一致性，又减少了手写代码的bug。