ArduPilot CubeGreen-solo 构建详解3DR SoloHex Green Cube专用 ArduCopter 固件的配置机制与默认参数体系【免费下载链接】ardupilotArduPlane, ArduCopter, ArduRover, ArduSub source项目地址: https://gitcode.com/GitHub_Trending/ar/ardupilot本篇围绕 CubeGreen-solo 硬件定义文档 展开讲解这一专供 3DR Solo 搭配 Hex Green Cube 飞控使用的 ArduCopter 构建目标是如何基于 CubeBlack 硬件定义派生而来的、如何用 waf 编译出arducopter.apj固件以及该构建内置的 140 余条默认参数defaults.parm分别覆盖了飞控姿态环、IMU 陷波滤波、Solo 专属电池监测、云台与 OSD 等哪些子系统。读完后你能准确理解该构建的适用前提、与通用 CubeBlack 构建的差异点并掌握完整可复现的编译流程。一、CubeGreen-solo 构建的定位与适用边界CubeGreen-solo 是 ArduPilot 针对 3DR Solo 无人机换装 Hex Green Cube 飞控后推出的专用构建目标。其核心事实可以归纳为与 CubeBlack 构建完全同构硬件层面它就是 CubeBlack 板子唯一的差异在于固件内置了一整套 Solo 所需的默认参数仅适用于 ArduCopter 3.7 及以上版本与更早版本的 ArduCopter 以及其他车型Plane、Rover、Sub 等不兼容仅用于“Green Cube 版 Solo”根据 hwdef.dat 文件头注释Green Cube 与 Black Cube 硬件相同但针对 Solo 的 ESC 兼容性问题改用 5V 电平信号this is based on the CubeBlack hwdef, with Solos required parameter defaults及uses 5v signalling for the Solo ESC issues因此不得将该 hwdef 用于除“Green Cube Solo 运行 Copter 4”之外的任何配置。官方文档还指出CubeBlack 板的详细硬件资料引脚、连接器、PWM 输出分组等应查阅 CubeBlack hwdef README该构建所使用的参数清单则可对照仓库中的 Solo-Copter-GreenCube.param 查看原文档链接到旧版路径Tools/Fram_params/Solo_Copter-3.7_GreenkCube.param当前仓库中对应的实际文件为上述路径且其文件头注明适用于 Copter 3.6 系列属于同一参数体系的早期版本。二、使用 waf 编译 CubeGreen-solo 固件原文档给出的标准编译流程非常简洁在仓库根目录下依次执行./waf configure --board CubeGreen-solo ./waf copter./waf configure --board CubeGreen-solo将构建目标指定为 CubeGreen-solo 板./waf copter编译 ArduCopter 固件编译完成后固件二进制文件位于build/CubeGreen-solo/bin/arducopter.apj。生成的.apj文件可通过任何 ArduPilot 兼容的地面站GCS经 MAVLink 刷入飞控——CubeBlack 板出厂即带有 ArduPilot 兼容的 bootloader见 CubeBlack README 的 “Loading Firmware” 一节。值得注意的构建系统细节是CubeGreen-solo 的 hwdef.dat 末尾声明了AUTOBUILD_TARGETS Copter即该板只应生成 Copter 目标这也与文档“不适用于其他车型”的说明一致。批量构建脚本 build_binaries.py 中同样对这一限制做了硬编码处理——skip_frame()函数会把CubeGreen-solo与bebop、CubeSolo等一起列入 heli 帧跳过名单进一步佐证该构建是纯粹的 Copter 目标。此外generate_manifest.py 中将其登记为(CubeGreen Solo, Hex/ProfiCNC)与 CubeBlack hwdef 中专属 Hex 的 USB VID0x2DAE“ONLY FOR USE BY HEX!”相互呼应。三、硬件定义层对 CubeBlack 的增量修改CubeGreen-solo 的 hwdef.dat 全文只有 19 行其结构非常典型——先整体包含 CubeBlack 的定义再做少量覆盖include ../CubeBlack/hwdef.dat undef AP_NOTIFY_OREOLED_ENABLED define AP_NOTIFY_OREOLED_ENABLED 1 undef HAL_SOLO_GIMBAL_ENABLED define HAL_SOLO_GIMBAL_ENABLED HAL_MOUNT_ENABLED undef AP_BATTERY_SMBUS_SOLO_ENABLED define AP_BATTERY_SMBUS_SOLO_ENABLED AP_BATTERY_SMBUS_ENABLED AUTOBUILD_TARGETS Copter这三处undefdefine正是 “Green Cube 版 Solo” 与通用 CubeBlack 构建的全部硬件级差异AP_NOTIFY_OREOLED_ENABLED置 1启用 OreoOLED屏幕驱动。Green Cube 板载一块 OLED 显示屏Solo 的 OSD 信息即通过该屏幕输出这是 Notify 框架下的显示设备之一HAL_SOLO_GIMBAL_ENABLED跟随HAL_MOUNT_ENABLEDSolo 的核心载荷是相机云台这里把 Solo 专属的云台硬件开关绑定到通用的 MOUNT 模块开关上保证云台功能与 AP_Mount 生命周期一致AP_BATTERY_SMBUS_SOLO_ENABLED跟随AP_BATTERY_SMBUS_ENABLEDSolo 的电池Smart Battery通过 SMBus 接口通信该宏使 SMbus 电池驱动在该构建中可用。其基础定义 CubeBlack/hwdef.dat 本身继承自fmuv3.inc关键硬件特性包括STM32F427 主控、两颗隔离的 SPI IMUMPU9250/ICM20602 LSM9DS0 或 ICM20948加一颗非隔离 IMU、双 MS5611 气压计、内置加速度计温度加热器HAL_HAVE_IMU_HEATER、IO-MCU 上的 8 路主 PWM 与 6 路支持 DShot 的辅助 PWM、以及通过ROMFS预置的 IO 固件iofirmware_cube_dshot_highpolh.bin/iofirmware_cube_highpolh.bin。文档中所说的“与 CubeBlack 构建完全相同”指的就是这一整套继承链。四、defaults.parmSolo 场景的默认参数体系defaults.parm 共 145 行注释标明“3DR Solo with Green Cube on Copter 4.0 only”。这些参数在首次启动时作为芯片出厂默认值写入参数区是文档中“large set of default parameters”的实体。按子系统分组解读如下4.1 姿态与角速率控制ACRO/ATC参数值含义ACRO_RP_P/ACRO_THR_MID/ACRO_YAW_P4 / 0.4 / 1Acro 模式滚转/横滚 P、油门中点、偏航 PAHRS_RP_P/AHRS_YAW_P0.21 / 0.21角速率反馈增益Solo 的响应被刻意收敛ATC_ANGLE_MAX20最大允许倾斜角 20°ATC_ACC_P/R/Y_MAX360 / 360 / 70加速度环各轴限幅deg/s² 量级偏航明显收紧ATC_ANG_PIT_P/ATC_ANG_RLL_P/ATC_ANG_YAW_P10 / 9 / 6角度环 P偏航仅为俯仰的 0.6 倍ATC_RAT_PIT_P/I/D/IMAX0.270 / 0.270 / 0.0075 / 0.444俯仰角速率环 PIDATC_RAT_RLL_P/I/D/IMAX0.200 / 0.200 / 0.005 / 0.444横滚角速率环 PIDATC_RAT_YAW_P/I/IMAX/FLTE0.5 / 0.05 / 0.222 / 7.6偏航角速率环偏航一阶滤波器 7.6 rad/sATC_RAT_PIT/RLL_FLTT/FLTD20 / 20俯仰横滚速率高通/低通滤波 20 rad/sATC_INPUT_TC0.15操纵输入时间常数 0.15sPILOT_THR_BHV/PILOT_THR_FILT7 / 2Solo 特有的油门行为模式与油门滤波模式PILOT_TKO_ALT_M2.14起飞高度 2.14m约为 Solo 离地所需高度这套参数整体呈现出“温和、受限”的风格偏航通道显著弱于俯仰/横滚配合 20° 的最大倾角与 2.14m 的起飞高度符合 Solo 作为航拍平台对稳定性的要求。4.2 惯性导航与 EKF参数值含义AHRS_EKF_TYPE/EK2_ENABLE/EK3_ENABLE3 / 0 / 1启用 NavEKF3禁用 NavEKF2EK3_IMU_MASK3启用 3 号实例可用的前两颗隔离IMUAHRS_ORIENTATION12飞控安装姿态Solo 机身上特定旋转INS_FAST_SAMPLE/INS_ACCEL_FILTER3 / 10快速采样模式与加速度计滤波档位INS_ACC_BODYFIX3机身固定安装模式INS_TRIM_OPTION2加速度计/陀螺仪配平方式INS_HNTCH_ENABLE/ATT/REF/BW1 / 40 / 0.26 / 200第一级陷波滤波在 40Hz 倾斜角门限以上、参考频率 0.26×采样频率、带宽 200Hz 生效用于抑制 Solo 电机谐波INS_HNTC2_ENABLE/ATT/FREQ/BW1 / 40 / 98 / 49第二级陷波固定 98Hz、带宽 49HzINS_HNTCH_FREQ200参考频率比例上限GPS_HDOP_GOOD/GPS_NAVFILTER200 / 6HDOP 门限 2.0GPS 定位模式 65xPPS3D 定位Solo 是四旋翼其振动特征与通用机架不同因此用两级可编程陷波一级自适应频率、二级固定 98Hz针对其电机/螺旋桨频率做了默认配置。4.3 Solo 电池系统与保护参数值含义BATT_MONITOR5使用 SMBus 电池类型对应 Solo 智能电池BATT_FS_VOLTSRC1电压源取自电池接口BATT_ARM_MAH/VOLT、BATT_CRT_MAH/VOLT250/13.5、250/13.5解锁与临界电量/电压阈值BATT_LOW_MAH/TIMER/VOLT520 / 10 / 14低电量告警条件容量、持续 10s、14VBATT_FS_CRT_ACT/BATT_FS_LOW_ACT2 / 2临界/低电量失效保护动作MOT_BAT_CURR_MAX/MOT_BAT_VOLT_MAX/MOT_BAT_VOLT_MIN50 / 16.8 / 13.2电调电池电流与电压标称值3S 锂电区间FS_THR_VALUE950油门失效保护 PWM 阈值FS_EKF_ACTION2EKF 失效时执行 RTLFS_GCS_ENABLE0关闭地面站失控保护Solo 场景BATT_MONITOR5与 hwdef 中AP_BATTERY_SMBUS_SOLO_ENABLED宏相呼应——硬件层使能 SMBus 驱动参数层将其选为电池监测源两者必须配套。4.4 云台、磁罗盘与串口参数值含义MNT1_TYPE21 号挂载类型跟随/云台MNT1_PITCH_MIN/MNT1_PITCH_MAX-90 / 0Solo 相机云台俯仰行程限制仅允许水平线以下COMPASS_ORIENT/COMPASS_DISBLMSK/COMPASS_USE338 / 15392 / 0内置磁罗盘安装方向与禁用掩码禁用板载磁计、依赖 GPS 组合模块外置磁计SERIAL1_BAUD921即 921600bpsSolo 数传波特率的参数分片写法SERIAL4_BAUD/SERIAL4_PROTOCOL230即 230400/ 1Solo 相机/云台链路的串口波特率与协议MAVLink 之外的协议SERVO1..4_FUNCTION33/34/35/36四路电机输出映射SERVO5..8经 SERVO5_FUNCTION 等由 MOT_ 参数隐含—Solo 的 4 电机由主 PWM 承载MAV2_PARAMS100参数区按 100% 比例划分给 MAV 接口NTF_LED_TYPES/NTF_OREO_THEME22 / 1板载 RGB LED 类型与 Oreo 显示主题其中SERIAL1_BAUD921、SERIAL4_BAUD230这类非整波特率数值是 Solo 历史遗留的特殊编码乘 100 倍存储属于该构建独有的“魔法值”直接修改时需谨慎。4.5 飞行模式、围栏与航点行为参数值含义FLTMODE1~6全部为 5六个 RC 通道模式全部固定为 PositionSolo 无摇杆切模概念FRAME_CLASS/FRAME_TYPE1 / 1固定翼类1此处为四旋翼Quad 四轴FENCE_ENABLE/FENCE_TYPE/FENCE_ACTION1 / 1 / 0启用半径围栏、动作 0仅告警不自动返航FENCE_ALT_MAX/FENCE_RADIUS122 / 0最大高度围栏 122m400ft适航空管常见限高半径 0 表示不限WP_SPD/WP_SPD_DN/WP_SPD_UP3 / 2.40 / 3.20航点水平/下降/爬升速度m/sWP_YAW_BEHAVIOR3航点偏航行为沿航向LOIT_ACC_MAX_M/LOIT_BRK_ACC_M/LOIT_BRK_DELAY/LOIT_SPEED_MS2.0 / 1.75 / 0.25 / 5.0Loiter 模式加减速与速度MOT_PWM_MAX/MOT_PWM_MIN/MOT_SPIN_ARM/MOT_SPIN_MIN/MOT_SPIN_MAX1900 / 1000 / 0.08 / 0.12 / 0.965Solo 电调的 PWM 窗口与起转阈值MOT_THST_EXPO0.8油门 Expo 曲线RC1/RC2/RC4 量程1000~2000通道范围RC3_MIN/MAX/TRIM1008 / 1890 / 1450Solo 油门通道收窄范围配合 PILOT_THR_BHV7 实现三段油门RC6_OPTION/RC6_TRIM/RC6_MAX213 / 1260 / 1520第 6 通道特殊功能与行程限制THR_DZ10油门死区 10μsPSC_NE_VEL_P/I、PSC_D_ACC_P/I1.41/0.51、0.05/0.1位置控制环东北方向速度环与加速度环增益BRD_PWM_VOLT_SEL1电压监测选择BRD_SAFETY_MASK/BRD_SAFETY_DEFLT16368 / 0安全开关掩码与默认状态LOG_BACKEND_TYPE/LOG_FILE_BUFSIZE/LOG_FILE_DSRMROT3 / 8 / 1日志后端类型、文件缓冲大小 8K、DS 轮转FENCE_ACTION0与FENCE_ENABLE1的组合是 Solo 的标志性策略围栏只告警、不越权接管把处置权留给地面站与飞手这与普通自组装多旋翼默认“越界即 RTL”的行为明显不同。五、使用前提与限制小结该构建只能用于 3DR Solo Hex Green Cube ArduCopter3.7/4.x不要把它刷给普通 CubeBlack 用户也不要用于其他车型硬件资料以 CubeBlack README 为准STM32F427、14 路 PWM、I2C/CAN、SD 卡等CubeGreen-solo 仅在 OLED 显示、Solo 云台硬件使能、Solo SMBus 电池三处做了增量编译产物路径为build/CubeGreen-solo/bin/arducopter.apj刷写方式与普通 CubeBlack 相同APj 经 GCS 上传defaults.parm只作用于首次刷入后的出厂默认值对已写入参数区参数的设备不产生追溯影响对照参数可参考 Solo-Copter-GreenCube.param。六、相关文件索引文件说明libraries/AP_HAL_ChibiOS/hwdef/CubeGreen-solo/README.md本文档主体构建定位与 waf 编译步骤libraries/AP_HAL_ChibiOS/hwdef/CubeGreen-solo/hwdef.dat硬件定义include CubeBlack 三处 Solo 增量 AUTOBUILD_TARGETS Copterlibraries/AP_HAL_ChibiOS/hwdef/CubeGreen-solo/defaults.parm145 行 Solo 默认参数libraries/AP_HAL_ChibiOS/hwdef/CubeBlack/README.mdCubeBlack 硬件资料引脚、连接器、PWM 分组libraries/AP_HAL_ChibiOS/hwdef/CubeBlack/hwdef.dat被包含的基础硬件定义IMU/气压计/磁计/IO 固件Tools/Frame_params/Solo-Copter-GreenCube.param同族参数清单Copter 3.6 版Tools/scripts/build_binaries.py批量构建时对该板 heli 帧的跳过逻辑L247-L253Tools/scripts/generate_manifest.py构建清单中 “CubeGreen Solo / Hex/ProfiCNC” 的登记【免费下载链接】ardupilotArduPlane, ArduCopter, ArduRover, ArduSub source项目地址: https://gitcode.com/GitHub_Trending/ar/ardupilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
