1. 为什么需要自定义参数在无人机和机器人开发中参数调校是让设备按照预期运行的关键。ArduPilot作为开源自动驾驶系统提供了数百个预设参数但实际开发中我们经常遇到需要添加新参数的情况。比如你可能需要为特殊传感器添加校准偏移量调整新开发的控制算法系数设置设备特有的机械参数如舵机行程量实现调试用的临时开关标志我去年给农业无人机开发喷洒系统时就遇到过需要新增药箱空载重量参数的情况。这个参数每更换药箱都需要调整如果硬编码在代码里每次都要重新编译固件非常不现实。通过自定义参数飞手在地面站就能直接修改效率提升了几十倍。2. 参数定义三板斧2.1 头文件声明打开libraries/AP_Param/Parameters.h这是所有参数的户口本。找到enum ap_var_type所在的区块在适当位置添加参数枚举k_param_my_pid_kp, // 放在同类参数附近 k_param_my_new_parameter, // 我们的新参数 k_param_next_existing_param接着声明参数变量。ArduPilot提供了多种参数类型常用的是AP_Int8 my_switch; // 1字节整型-128~127 AP_Int16 my_angle; // 2字节整型常用 AP_Float my_scale; // 4字节浮点 AP_Vector3f my_offset; // 3维向量我建议用AP_Int16作为入门选择它兼顾了取值范围和存储效率。比如声明一个PID参数AP_Int16 my_pid_kp; // 声明在文件末尾的变量区2.2 参数注册实现转到Parameters.cpp这里要给参数办身份证。找到GSCALAR宏所在的区域约在文件中部添加参数注册// Param: MY_PID_KP // DisplayName: PID比例系数 // Description: 控制回路的比例增益系数\n建议值范围10-100 // Range: 0 500 // Units: % // User: Advanced GSCALAR(my_pid_kp, MY_PID_KP, MY_PID_KP_DEFAULT),关键点说明Range定义了地面站的滑块范围Units会显示单位符号\n在描述中换行User分级建议选Advanced避免误操作2.3 默认值设置在config.h中添加默认值定义。这个文件像参数的出生证明#ifndef MY_PID_KP_DEFAULT #define MY_PID_KP_DEFAULT 50 // 默认50% #endif建议默认值设为典型使用场景的中位值。我曾见过新手设为0导致设备一上电就失控的情况这点要特别注意。3. 让参数活起来3.1 参数调用实战参数注册只是开始真正的价值在于使用。在需要调用的模块中#include AP_Param/AP_Param.h extern const AP_Param::GroupInfo var_info[]; // 访问参数库 void ControlModule::update_pid() { float kp my_pid_kp.get() * 0.01f; // 转换为浮点系数 // 使用kp进行控制计算... }注意.get()方法会返回参数当前值。对于浮点参数ArduPilot内部存储的是缩放后的整型比如角度可能用centidegree0.01度为单位。3.2 地面站调试输出在Rover.cpp或其他机型主文件中添加调试输出void Rover::send_debug_info() { gcs().send_text(MAV_SEVERITY_INFO, PID参数: KP%d KI%d, (int)g.my_pid_kp.get(), (int)g.my_pid_ki.get()); }这个输出会显示在Mission Planner的状态标签页。我习惯用MAV_SEVERITY_INFO级别比DEBUG级别更显眼。4. 地面站联调技巧4.1 参数刷新机制烧录新固件后地面站可能需要强制刷新参数列表断开飞控USB删除地面站缓存Mission Planner的Config/Tuning→Full Parameter List→右键Clear All Params重新连接并按F5刷新有时会遇到参数不显示的情况多半是参数名拼写不一致导致的。有次我因为把MY_PARAM写成MY_PARAM_多了下划线调试了两小时。4.2 参数录制与回放在地面站的飞行数据页面右键图表→添加参数→输入MY_PID_*支持通配符点击录制按钮操作设备观察参数变化使用回放功能分析参数影响这个功能特别适合调PID参数。我通常会在参数名后加_LOG后缀专门用于记录比如MY_PID_KP_LOG。5. 高级技巧与避坑指南5.1 参数版本兼容当升级固件时旧参数可能失效。建议在参数名中加入版本标记// V2表示第二个版本 GSCALAR(my_wing_ratio_v2, WING_RATIO_V2, 50),我曾经因为没做版本控制导致用户升级后所有参数重置被客户投诉了好几次。5.2 参数分组管理对于复杂系统可以使用GROUPSTART和GROUPEND创建参数组// Group: CAM_ // Path: ../libraries/AP_Camera/AP_Camera.cpp GROUPSTART(Camera) // Param: CAM_TYPE // DisplayName: Camera type GSCALAR(type, TYPE, 0), GROUPEND(Camera)这样在地面站中所有相机参数都会归类显示。无人机项目中有次我把云台和相机参数混在一起调试时简直是一场灾难。5.3 参数存储优化ArduPilot默认将所有参数存储在EEPROM中。对于频繁修改的调参参数可以标记为临时参数// User: Temp GSCALAR(temp_debug_flag, DEBUG_FLAG, 0),临时参数不会自动保存适合调试阶段使用。但切记正式版要去掉这个标记我有次发布后客户抱怨参数无法保存就是这个原因。