3. MAVLink 1.0 vs 2.0：版本差异对比、签名机制、兼容性处理、如何选择版本

好，咱们进入第三章。说实话，MAVLink 的版本问题，是我在跟很多工程师交流时发现最容易踩坑的地方。很多人觉得「不就是换个协议版本嘛，改个宏定义就行了」。嗯，如果你真这么想，那后面调试的时候可能会很头疼。

这一章，我带你彻底搞清楚 MAVLink 1.0 和 2.0 到底差在哪，签名机制怎么用，以及在实际项目中该怎么选。

3.1 版本差异：从帧结构说起

先看最核心的东西——数据包长什么样。MAVLink 1.0 的帧结构比较简洁，但 2.0 在头部做了大改动。

你看，最直观的区别就是消息 ID 从 1 字节变成了 3 字节。这意味着什么？MAVLink 1.0 最多只能定义 256 种消息，而 2.0 可以定义超过 1600 万种。我在做无人机集群项目时，需要自定义一些内部通信消息，1.0 的 ID 空间很快就用完了。后来切到 2.0，才彻底解放。

另外，2.0 的起始标志改成了 0xFD。这个细节很重要——接收端可以通过判断第一个字节是 0xFE 还是 0xFD 来区分版本。我见过有人把两个版本混在一起用，结果解析器直接崩了。嗯，这里要注意：同一个链路上不要同时混发 1.0 和 2.0 的包，除非你做了明确的路由隔离。

3.2 签名机制：安全不是可选项

MAVLink 2.0 最大的亮点，就是引入了可选的签名机制。为什么需要签名？说白了，就是防止有人往你的飞控里注入假数据。

我曾经在一个公开演示项目里，遇到过有人用地面站软件故意发送伪造的 HEARTBEAT 包，导致飞控误判链路状态。那之后，我对签名机制就特别上心。

签名机制的工作原理是这样的：

1. 发送方和接收方预先共享一个 32 字节的密钥
2. 发送方对整包（包括头部、有效载荷、校验和）计算 SHA-256 哈希，取前 6 字节作为签名
3. 接收方用同样的密钥和算法验证签名

签名数据放在包的最后，共 13 字节：

签名结构 (13字节):
+--------+--------+--------+--------+--------+--------+--------+--------+
|  Link ID (1B)  |   Timestamp (6B)   |         Signature (6B)          |
+--------+--------+--------+--------+--------+--------+--------+--------+

• Link ID：链路标识，用于区分不同的通信链路
• Timestamp：时间戳，防止重放攻击
• Signature：6 字节的哈希值

我个人的习惯是：只要链路暴露在公共网络或无线电环境中，就开启签名。比如用 4G 模块做数传时，签名几乎是必须的。但在机载内部总线（比如 UART 直连）上，为了节省那 13 字节的开销，我通常会关掉签名。

3.3 兼容性处理：让新旧设备共存

现实项目中，你很难一次性把所有设备都升级到 2.0。兼容性处理就成了必修课。

MAVLink 官方推荐的做法是：自动检测 + 协议协商。

具体来说：

• 设备启动时，先发一个 MAVLink 1.0 格式的 HEARTBEAT
• 如果对方回复的是 2.0 格式的 HEARTBEAT，则切换到 2.0
• 如果对方回复的是 1.0 格式，则保持 1.0

这个逻辑看起来简单，但我在实际集成时踩过一个坑：有些飞控固件默认只发 2.0 包，导致老版本地面站完全收不到 HEARTBEAT。后来我在代码里加了一个 fallback 机制——如果连续 3 秒没收到任何回复，就降级到 1.0 重试。

3.4 如何选择版本：一张决策图帮你搞定

说了这么多，到底该用哪个版本？我整理了一张决策流程图，你可以对照自己的项目情况来判断。

这张图的核心逻辑其实就三条：

• 消息数量超过 255 种：没得选，必须上 2.0
• 需要安全签名：2.0 是唯一选择
• 需要兼容老设备：用自动协商，或者干脆强制 1.0

我个人的建议是：新项目直接上 MAVLink 2.0。原因很简单——1.0 的 256 个消息 ID 在今天的无人机系统里已经捉襟见肘了。你想想看，光是 PX4 和 ArduPilot 的标准消息就占了将近 200 个，留给自定义的空间非常有限。

3.5 实战中的版本切换代码

最后，给你看一段我在实际项目中用过的版本切换代码。这段代码运行在机载计算机上，负责自动检测地面站的协议版本。

// 伪代码：MAVLink 版本自动协商
void mavlink_version_negotiation() {
    // 1. 先发一个 1.0 格式的 HEARTBEAT
    mavlink_message_t msg;
    mavlink_msg_heartbeat_pack(1, 1, &msg, MAV_TYPE_QUADROTOR,
                               MAV_AUTOPILOT_PX4, MAV_MODE_FLAG_CUSTOM_MODE_ENABLED,
                               0, MAV_STATE_ACTIVE);
    
    // 2. 等待回复，超时 3 秒
    uint8_t buffer[MAVLINK_MAX_PACKET_LEN];
    int len = uart_receive(buffer, sizeof(buffer), 3000);
    
    if (len > 0) {
        mavlink_status_t status;
        mavlink_message_t rx_msg;
        
        for (int i = 0; i < len; i++) {
            if (mavlink_parse_char(MAVLINK_COMM_0, buffer[i], &rx_msg, &status)) {
                // 3. 检查回复的起始标志
                if (buffer[0] == 0xFD) {
                    // 对方支持 2.0，切换
                    current_protocol_version = 2;
                    mavlink_set_proto_version(MAVLINK_COMM_0, 2);
                } else {
                    // 对方只支持 1.0
                    current_protocol_version = 1;
                }
                break;
            }
        }
    } else {
        // 超时未收到回复，降级到 1.0
        current_protocol_version = 1;
    }
}

这段代码看起来简单，但有几个细节要注意：

• 超时时间不能太短：我试过 1 秒，结果在信号不好的时候频繁切换，导致链路抖动。3 秒是比较稳妥的值。
• 不要只检查一次：最好连续成功 3 次再确认版本切换，避免误判。
• 版本切换后要重置解析器：否则解析器里残留的旧版本数据会导致后续解析失败。