ArduPilot 入门教程零硬件起步3 条命令跑通从 SITL 仿真到真机首飞【免费下载链接】ardupilotArduPlane, ArduCopter, ArduRover, ArduSub source项目地址: https://gitcode.com/GitHub_Trending/ar/ardupilot第一次让多旋翼在无人看管下自主返航时多数人最担心的不是飞不起来而是失联之后它会做什么GPS 丢失后往哪飞、低电量在什么高度触发降高。这类问题的答案都写在飞控代码里而 ArduPilot 正是把飞行逻辑全部开放的开源无人机飞控系统——GPLv3 许可同一套代码库覆盖多旋翼、固定翼、地面车辆与水下机器人。认知地图一套代码库覆盖五类载具先用下表建立整体概念再决定从哪里读起条目内容载具平台五大入口ArduCopter / ArduPlane / Rover / ArduSub / AntennaTracker许可证GPLv3全文见 COPYING.txt硬件抽象层libraries/AP_HAL/含 ChibiOS、SITL、Linux、ESP32 等核心控制库libraries/AC_AttitudeControl/、libraries/AP_AHRS/、libraries/AP_NavEKF3/ 等测试体系tests/ 单元测试、Tools/autotest/ SITL 自动化飞行测试判断入口的方法很直接多旋翼进 ArduCopter/固定翼与 VTOL 进 ArduPlane/轮式/履带/船进 Rover/ROV 进 ArduSub/。每个目录里的mode_*.cpp是各模式实现failsafe.cpp是安全逻辑Parameters.cpp是参数定义这三类文件是读代码的起点。 上手路线零硬件跑通 SITL 仿真第一步克隆仓库并初始化子模块git clone https://gitcode.com/GitHub_Trending/ar/ardupilot cd ardupilot git submodule update --init --recursive原因构建脚本 waf、ChibiOS 系统、mavlink 协议库都在子模块里跳过 init 步骤是构建失败最常见的原因。第二步构建 SITL 版 ArduCopter./waf configure --board sitl ./waf copter原因SITL软件在环跑的是和真机完全一致的飞行逻辑只有硬件抽象层不同AP_HAL_SITL 对比 AP_HAL_ChibiOS在仿真里验证过的模式切换、failsafe 和参数设置可以原样带到真机。构建体系的完整说明见 BUILD.md。第三步启动仿真与地面站./Tools/autotest/sim_vehicle.py -v ArduCopter原因该脚本同时拉起仿真载具和 MAVProxy 地面站见 Tools/autotest/sim_vehicle.py 头部说明在地面站里就能完成 arm、起飞、模式切换、RTL 返航这一整套真机最关心的动作硬件成本为零。第四步硬件选型与真机首飞准备上真机时运行./waf list_boards查看可构建的板子列表按载具需要的接口选型。仓库里每块板子在libraries/AP_HAL_ChibiOS/hwdef/下都有引脚图以 CM4Pilot 为例确认板卡后把 configure 的--board换成实际板名重跑./waf copter再用--upload选项刷入完整流程见 BUILD.md。真机首飞建议先拆桨做地面测试完成传感器校准、确认 arming 检查项全部通过再低空试飞。 平台选型按任务场景选模式而不是按机型航拍测绘选 ArduCopter核心模式PosHoldGPS 位置悬停、Loiter、Auto任务执行。独有能力相机触发与云台控制实现在 libraries/AP_Camera/ 和 libraries/AP_Mount/Auto 模式的任务逻辑见ArduCopter/mode_auto.cpp。注意起飞前确认 GPS 3D 定位和罗盘状态RTL 返航依赖家点坐标。长航时巡航选 ArduPlane核心模式Cruise、Loiter、Auto、Autoland。独有能力TECS总能量控制系统用油门和升降舵共同管理总能量代码在 libraries/AP_TECS/是固定翼爬升平滑、能耗可控的关键。注意必须配置最低安全空速并安装空速传感器抛伞逻辑在ArduPlane/parachute.cpp。地面巡检选 Rover核心模式Hold、Steering、Loiter、RTL。独有能力路径跟踪与自主导航Rover/mode_auto.cpp另有平衡机器人balance_bot.cpp、帆船sailboat.cpp。注意轮式载具没有悬停概念姿态控制逻辑和多旋翼完全不同不要直接套用多旋翼的调参经验。水下作业选 ArduSub核心模式Surface水面、SurfaceTrack水面跟踪、深度保持。独有能力浮力补偿——ArduSub/Parameters.cpp中提供 Buoyancy 相关参数用于抵消不同深度下重力与浮力的失衡深度保持依赖气压计控制链路和多旋翼的高度保持不同。注意气压计失效后的行为与高度 failsafe 不同水下作业的安全策略建议先在 SITL 里单独验证。️ 避坑清单四轴调参、校准与安全设置的排查思路PID 震荡→ 排查思路先不动 PID用出厂默认参数飞行一次只调一个轴Roll/Pitch/Yaw每次调整后用 DataFlash 日志回看姿态控制参数在 libraries/AC_AttitudeControl/。刷完机后定位不稳、姿态漂移→ 排查思路加速度计和罗盘校准没做。先跑板载校准再检查罗盘模型与磁偏角最后排查电机、电源线的干扰源。failsafe 触发后行为意外→ 排查思路GPS/遥控/电池 failsafe 触发后的动作全部由参数决定。先读默认行为ArduCopter/failsafe.cpp再逐项修改改完先在仿真里触发一次确认。飞行中丢 GPS 定位→ 排查思路检查天线安装位置远离金属与电机起飞前确认 3D 定位单独验证定位丢失后的 RTL 高度与目标点是否符合预期。电调响应迟缓、电机转向错→ 排查思路用 Copter 内置的 ESC 校准ArduCopter/esc_calibration.cpp校准信号范围核对电机顺序与桨安装方向一致。模式切换失败→ 排查思路检查遥控通道映射libraries/RC_Channel/在地面站确认当前模式与通道数值失败后回看日志定位是通道未触发还是模式被安全检查拦截。生态与入口文档、社区与贡献路径文档入口BUILD.md 讲构建与刷写README.md 讲项目构成docs/ 提供 doxygen 文档生成配置Doxyfile.in。测试入口tests/ 里的单元测试可本地运行Tools/autotest/ 是完整的 SITL 自动飞行测试集适合用它观察每个模式和 failsafe 的真实行为。社区入口README.md 中列有官方支持论坛与 Discord 频道打开该文件即可获取地址。贡献路径从修已知 bug 开始或为改动补单元测试、SITL 测试用例代码风格有现成脚本Tools/CodeStyle/ardupilot-astyle.sh。下一步建议克隆仓库配置 sitl 板启动 ArduCopter 仿真在地面站里完成一次 arm、起飞、RTL 返航的完整循环然后对照ArduCopter/failsafe.cpp逐条核对默认安全参数的行为再开始考虑真机。【免费下载链接】ardupilotArduPlane, ArduCopter, ArduRover, ArduSub source项目地址: https://gitcode.com/GitHub_Trending/ar/ardupilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考