3. PX4开发环境搭建
PX4 的固件规模庞大，包含飞控主程序、驱动、中间件、仿真模型、地面站通信与自动化测试等多个子系统。要让这套代码在本地“能编译、能仿真、能连硬件”，必须先把工具链、依赖库、地面站和仿真器一次性配置到位。本节围绕 Ubuntu 环境，梳理从系统准备到 HIL（硬件在环）仿真的完整搭建路径，并给出常见问题的排查思路。
一、核心原理：PX4 构建系统的依赖关系
PX4 的构建并不是“一个编译器加一个 Makefile”那么简单。它采用 CMake 作为构建系统，通过 make px4_fmu-v6x_default 这类目标触发 CMake 配置，再由 GCC 交叉编译生成飞控固件；同时用 Python 脚本完成参数生成、uORB 消息生成、上传与仿真启动等任务。仿真侧则依赖 Gazebo 提供物理引擎与传感器模型，QGroundControl 负责地面站交互。理解这条依赖链，才能判断“编译失败”到底卡在哪一层。
二、方法流程：从零到可仿真的标准步骤
推荐按“系统 → 源码 → 工具链 → 仿真 → 地面站 → 验证”的顺序推进，每一步都做一次最小验证，避免问题堆积。
- 系统准备：安装 Ubuntu 22.04 LTS，执行
sudo apt update && sudo apt upgrade，并确保磁盘剩余空间不少于 30 GB。 - 获取源码：克隆 PX4-Autopilot 并同步子模块，注意子模块体积较大，网络不稳定时容易失败。
- 安装工具链：运行官方脚本安装 GCC、CMake、Ninja、Python 依赖与仿真依赖。
- 编译固件：先编译 SITL 目标验证工具链，再编译真实飞控目标。
- 启动仿真：用 Gazebo 加载固定翼或 VTOL 机型，观察模型是否正常生成。
- 连接地面站：启动 QGroundControl，确认能自动连接并读取参数。
- 配置 HIL：将真实飞控通过 USB/串口接入，切换 HIL 模式，验证传感器数据回传。
# 1. 获取源码与子模块
git clone https://github.com/PX4/PX4-Autopilot.git --recursive
cd PX4-Autopilot
# 2. 安装依赖与工具链
bash ./Tools/setup/ubuntu.sh
# 3. 编译 SITL 目标（先验证工具链）
make px4_sitl_default
# 4. 启动 Gazebo 固定翼仿真
make px4_sitl gazebo-classic_plane
# 5. 启动 QGroundControl（另开终端）
./QGroundControl.AppImage
三、关键组件配置要点
| 组件 | 作用 | 验证方式 | 常见问题 |
|---|---|---|---|
| Ubuntu | 基础运行环境 | lsb_release -a |
版本过旧导致依赖缺失 |
| Git | 源码与子模块管理 | git submodule status |
子模块未同步、网络超时 |
| GCC | 交叉编译飞控固件 | arm-none-eabi-gcc --version |
版本不匹配、路径未加入 |
| CMake | 构建系统配置 | cmake --version |
版本过低导致配置失败 |
| Python 3 | 脚本、参数与工具链 | python3 --version |
缺少 pip 包或虚拟环境冲突 |
| QGroundControl | 地面站与调参 | 能自动连接并显示参数 | 串口权限、驱动缺失 |
| Gazebo | 物理仿真与传感器模型 | 模型正常加载并起飞 | 显卡驱动、模型下载失败 |
| HIL | 真实飞控接入仿真 | 传感器数据回传正常 | 串口波特率、模式切换错误 |
四、案例场景：固定翼 VTOL 的 SITL 与 HIL 验证
以一架标准 VTOL 机型为例，先在 SITL 下验证多旋翼与固定翼模式切换逻辑，再接入真实飞控做 HIL。SITL 阶段重点观察 Gazebo 中的姿态响应、QGC 中的飞行模式切换和 MAVLink 心跳；HIL 阶段则把真实飞控的传感器数据注入仿真，验证飞控在真实硬件上的解算与输出是否一致。若 SITL 正常而 HIL 异常，优先检查串口连接、HIL 模式参数与传感器校准状态。
提示：首次编译建议先执行
make px4_sitl_default，它不依赖真实飞控硬件，能快速暴露工具链和依赖问题。确认 SITL 通过后，再编译 px4_fmu-v6x_default 等硬件目标。
五、误区与复盘
- 误区一：只装 GCC 就以为能编译。PX4 还依赖 CMake、Ninja、Python 包和大量系统库，缺一不可。
- 误区二：忽略子模块。克隆时未加
--recursive，会导致编译时找不到 uORB 或驱动源码。 - 误区三：QGC 连不上就重装。多数情况是串口权限或驱动问题，先检查
dialout组和ls /dev/tty*。 - 误区四：Gazebo 黑屏就放弃。通常是显卡驱动或 OpenGL 渲染问题，可尝试切换渲染后端或更新驱动。
- 误区五：HIL 与 SITL 混用参数。两者对传感器来源和模式要求不同，切换时务必重新校准并检查参数。
注意：HIL 仿真中真实飞控会输出电机信号，务必拆除螺旋桨或使用安全开关，避免意外启动造成伤害。
完成以上配置后，你就拥有了一套可编译、可仿真、可接硬件的 PX4 开发环境。后续的机型适配、控制律调试和任务规划，都可以在这套环境上逐步展开。