润07131. 项目概述：PX4 Offboard模式参数调试实战
最近在无人机飞控开发中，PX4的Offboard模式调试是个高频需求场景。这种模式下飞控通过MAVLink协议接收外部指令（如来自机载计算机的路径规划命令），实现完全自主飞行。但实际调试中，参数配置不当会导致飞行器响应迟钝、轨迹偏离甚至失控。本文将基于真实项目经验，详解Offboard模式的核心参数调试方法论。
Offboard模式本质上是通过MAVROS（ROS与MAVLink的桥梁）或直接MAVLink通信，将外部系统生成的设定点（setpoint）持续发送给飞控。与Mission模式不同，Offboard要求外部系统以至少2Hz的频率发送指令，否则飞控会自动切换回Hold模式。这种实时性要求使得参数调试尤为关键。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心参数解析与调试策略
2.1 控制回路参数组
MPC_XY_CRUISE（默认3m/s）
决定水平方向巡航速度，过高会导致转弯时轨迹过冲。实测建议：
- 小型无人机（轴距<450mm）：1.5-2.5m/s
- 中型无人机（轴距450-800mm）：2.5-4m/s
调试方法：在Gazebo中用make px4_sitl gazebo_iris启动仿真，通过QGC的MAVLink控制台实时修改：
bash复制param set MPC_XY_CRUISE 2.0
param save
MPC_XY_ERR_MAX（默认2m）
位置控制器最大容错距离。当设定点与实际位置偏差超过此值时，飞控会触发失控保护。在复杂环境中（如室内GPS拒止）需适当调大，但超过3m会增加碰撞风险。
2.2 Offboard专属参数
COM_OF_LOSS_T（默认0.5s）
Offboard指令超时判定阈值。若外部系统停止发送指令超过该时间，飞控自动切换模式。在机载计算机算力不足时，建议增大至1.0s，但会降低安全性。
MAV_ODOM_LP
视觉里程计延迟补偿参数。使用VIO（如T265）时，若观察到轨迹震荡，需按以下公式计算补偿值：
code复制补偿值 = 平均传输延迟 + 处理延迟 + 0.05（安全余量）
典型值范围0.05-0.15s。