4. MAVLink 参数读写流程：从单参数到全列表的实战拆解

参数读写，说白了就是地面站和飞控之间的“讨价还价”。你告诉飞控“我要看这个参数”，飞控把值发回来；你告诉飞控“把这个参数改成那个值”，飞控确认“改好了”。

整个过程看起来简单，但坑不少。我最早做飞控调试时，就因为在参数写入后没等确认就直接断电，结果参数没存住，炸了一架机。嗯，从那以后我对这个流程就特别较真。

这一章，我们把参数读写的四个核心场景拆开揉碎：

• 读取单个参数
• 读取全部参数列表
• 写入单个参数
• 参数写入确认机制

每个场景我都会结合 MAVLink 协议栈的实际报文交互来讲，顺便带上我踩过的坑。

4.1 读取单个参数的完整流程

读取单个参数，最常见的场景就是调试时想看看某个关键参数当前是多少。比如我想看 MIS_ALT_DEF 这个高度默认值。

流程其实就两步：

1. 地面站发送请求：PARAM_REQUEST_READ 报文，里面带上参数名或参数索引。
2. 飞控回复参数值：PARAM_VALUE 报文，包含参数名、参数值、参数类型和总参数数量。

这里有个细节——你可以用参数名请求，也可以用参数索引请求。我个人习惯用参数名，因为可读性强，调试时一眼就知道在查什么。

// 地面站 -> 飞控
PARAM_REQUEST_READ {
    target_system: 1,
    target_component: 1,
    param_id: "MIS_ALT_DEF",   // 参数名，16字节
    param_index: -1             // -1 表示使用 param_id
}

// 飞控 -> 地面站
PARAM_VALUE {
    param_id: "MIS_ALT_DEF",
    param_value: 10.0,          // 浮点数值
    param_type: MAV_PARAM_TYPE_REAL32,
    param_count: 256,           // 总参数数量
    param_index: 42             // 该参数在列表中的索引
}

4.2 读取全部参数列表的流程

读取全部参数列表，说白了就是“把飞控里所有参数都拉一遍”。地面站启动时，或者飞控固件升级后，都需要做这个操作。

流程是这样的：

1. 地面站发送 PARAM_REQUEST_LIST，告诉飞控“我要全部参数”。
2. 飞控从索引 0 开始，逐个发送 PARAM_VALUE 报文，直到 param_index == param_count - 1。
3. 地面站收到所有参数后，构建本地参数缓存。

你想想看，如果飞控有 500 个参数，那就得收 500 个 PARAM_VALUE 报文。这中间要是丢了一个，地面站就得重新请求整个列表。

这里有个性能优化点：参数列表的传输是串行的。飞控一次只能发一个参数，不能并发。所以参数越多，读取时间越长。我见过一些飞控固件，参数数量超过 1000 个，光读取参数列表就要十几秒。

4.3 写入单个参数的流程

写入参数比读取要复杂一点，因为涉及确认机制。流程如下：

1. 地面站发送 PARAM_SET 报文，带上参数名和要写入的值。
2. 飞控收到后，先校验参数是否存在、值是否合法。
3. 如果校验通过，飞控更新内存中的参数值，然后回复 PARAM_VALUE 报文。
4. 地面站收到 PARAM_VALUE 后，比对值是否与写入值一致。

这里有个容易忽略的点：飞控回复的 PARAM_VALUE 里的值，是写入后的值，不是写入前的值。所以地面站可以通过比对来确认写入是否成功。

// 地面站 -> 飞控
PARAM_SET {
    target_system: 1,
    target_component: 1,
    param_id: "MIS_ALT_DEF",
    param_value: 15.0,          // 要写入的值
    param_type: MAV_PARAM_TYPE_REAL32
}

// 飞控 -> 地面站（确认）
PARAM_VALUE {
    param_id: "MIS_ALT_DEF",
    param_value: 15.0,          // 写入后的值
    param_type: MAV_PARAM_TYPE_REAL32,
    param_count: 256,
    param_index: 42
}

4.4 参数写入确认机制

为什么需要确认机制？说白了，就是怕丢包。你发了 PARAM_SET，飞控可能没收到，或者收到了但写入失败，或者写入成功但确认报文丢了。

MAVLink 协议本身没有强制要求重传，但实际工程中，地面站必须实现超时重传机制。我一般这样设计：

1. 发送 PARAM_SET 后，启动一个 500ms 的超时计时器。
2. 如果在超时前收到对应的 PARAM_VALUE，比对值是否一致。
3. 如果一致，标记写入成功。
4. 如果不一致或超时，重发 PARAM_SET，最多重试 3 次。
5. 3 次都失败，向用户报告写入失败。

所以，完整的写入确认机制应该包含两层：

第二层在标准 MAVLink 协议里没有强制要求，但很多飞控固件（比如 ArduPilot、PX4）会通过 STATUSTEXT 报文通知“参数已保存”。我个人建议，地面站收到 PARAM_VALUE 确认后，再等一个“保存完成”的通知，才算真正的写入成功。