1. Ubuntu环境准备与PX4源码获取在开始PX4固件编译之前我们需要确保Ubuntu系统环境配置正确。虽然官方推荐使用Ubuntu 18.04但实测Ubuntu 20.04和22.04也能完美兼容。这里以Ubuntu 20.04为例演示完整的环境搭建过程。1.1 系统依赖安装首先更新软件源并安装基础工具链sudo apt update sudo apt upgrade -y sudo apt install -y git zip qtcreator cmake build-essential ninja-build特别要注意的是必须移除可能干扰串口通信的modemmanagersudo apt-get remove modemmanager -y1.2 用户权限配置PX4官方强烈警告不要使用sudo解决权限问题。正确做法是将当前用户加入dialout组sudo usermod -a -G dialout $USER newgrp dialout # 立即生效无需重启1.3 获取PX4源码建议在用户目录下创建工作空间mkdir -p ~/px4_ws/src cd ~/px4_ws/src git clone https://github.com/PX4/PX4-Autopilot.git --recursive如果遇到子模块更新失败特别是国内网络环境可以尝试cd PX4-Autopilot git submodule sync --recursive git submodule update --init --recursive --jobs42. 依赖工具链安装2.1 自动化安装脚本PX4提供了便捷的环境配置脚本bash ./PX4-Autopilot/Tools/setup/ubuntu.sh这个脚本会自动安装ARM交叉编译工具链gcc-arm-none-eabiPython3开发环境Gazebo仿真器依赖代码格式化工具2.2 常见问题处理如果脚本执行中出现网络超时可以手动重试失败的部分。例如Python包安装失败时pip3 install --user numpy toml pandas jinja2 pyyaml3. Pixhawk固件编译实战3.1 选择编译目标进入源码目录查看支持的硬件cd ~/px4_ws/src/PX4-Autopilot make list_config_targets | grep pixhawk对于Pixhawk 6X硬件应使用make px4_fmu-v6x_default3.2 编译过程详解完整编译会经历以下阶段CMake配置生成交叉编译NuttX系统编译PX4中间件链接生成最终固件首次编译可能需要15-30分钟后续增量编译只需1-2分钟。如果遇到ninja报错执行make clean make px4_fmu-v6x_default3.3 固件烧录通过USB连接Pixhawk后执行make px4_fmu-v6x_default upload成功烧录后会显示Erase : [] 100.0% Program: [] 100.0% Verify : [] 100.0%4. 自定义模块开发与集成4.1 源码结构解析关键目录说明src/ ├── examples/ # 官方示例代码 ├── modules/ # 系统模块 └── drivers/ # 硬件驱动4.2 添加新功能模块以创建简单的状态指示灯模块为例在src/examples下新建led_controller目录创建led_controller.cpp实现模块逻辑在boards/px4/fmu-v6x/default.cmake中添加examples/led_controller4.3 编译验证重新编译后会看到新模块被包含[100%] Linking CXX executable px4_fmu-v6x_default.elf [100%] Built target led_controller5. 常见问题解决方案5.1 子模块更新失败典型错误fatal: clone of https://github.com/... failed解决方法删除卡住的子模块目录设置git代理或更换镜像源使用--jobs1降低并行下载数量5.2 内存不足错误编译Pixhawk 1FMUv2时可能出现region flash overflowed by 1234 bytes解决方案移除不必要模块使用make px4_fmu-v3_default替代5.3 地面站连接问题如果QGroundControl无法识别设备检查/dev/serial/by-id设备权限确保没有其他程序占用串口更新Pixhawk bootloader6. 进阶开发技巧6.1 使用VSCode开发安装扩展C/CCMake ToolsPX4-Autopilot配置settings.json{ cmake.configureArgs: [ -DCMAKE_BUILD_TYPEDebug, -DPX4_BOARDfmu-v6x ] }6.2 仿真测试启动Gazebo仿真make px4_sitl gz_x500支持多种仿真器jMAVSim轻量级Gazebo高精度AirSim视觉仿真6.3 性能优化启用ccache加速编译export CCACHE_DIR$HOME/.ccache ccache -M 5G使用多核编译make -j$(nproc) px4_fmu-v6x_default经过实际项目验证这套开发流程在Pixhawk 6X上运行稳定。记得在修改关键参数后务必进行充分的仿真测试再实际上机验证。
【Pixhawk】Ubuntu下PX4固件编译实战：从环境搭建到自定义模块集成
1. Ubuntu环境准备与PX4源码获取在开始PX4固件编译之前我们需要确保Ubuntu系统环境配置正确。虽然官方推荐使用Ubuntu 18.04但实测Ubuntu 20.04和22.04也能完美兼容。这里以Ubuntu 20.04为例演示完整的环境搭建过程。1.1 系统依赖安装首先更新软件源并安装基础工具链sudo apt update sudo apt upgrade -y sudo apt install -y git zip qtcreator cmake build-essential ninja-build特别要注意的是必须移除可能干扰串口通信的modemmanagersudo apt-get remove modemmanager -y1.2 用户权限配置PX4官方强烈警告不要使用sudo解决权限问题。正确做法是将当前用户加入dialout组sudo usermod -a -G dialout $USER newgrp dialout # 立即生效无需重启1.3 获取PX4源码建议在用户目录下创建工作空间mkdir -p ~/px4_ws/src cd ~/px4_ws/src git clone https://github.com/PX4/PX4-Autopilot.git --recursive如果遇到子模块更新失败特别是国内网络环境可以尝试cd PX4-Autopilot git submodule sync --recursive git submodule update --init --recursive --jobs42. 依赖工具链安装2.1 自动化安装脚本PX4提供了便捷的环境配置脚本bash ./PX4-Autopilot/Tools/setup/ubuntu.sh这个脚本会自动安装ARM交叉编译工具链gcc-arm-none-eabiPython3开发环境Gazebo仿真器依赖代码格式化工具2.2 常见问题处理如果脚本执行中出现网络超时可以手动重试失败的部分。例如Python包安装失败时pip3 install --user numpy toml pandas jinja2 pyyaml3. Pixhawk固件编译实战3.1 选择编译目标进入源码目录查看支持的硬件cd ~/px4_ws/src/PX4-Autopilot make list_config_targets | grep pixhawk对于Pixhawk 6X硬件应使用make px4_fmu-v6x_default3.2 编译过程详解完整编译会经历以下阶段CMake配置生成交叉编译NuttX系统编译PX4中间件链接生成最终固件首次编译可能需要15-30分钟后续增量编译只需1-2分钟。如果遇到ninja报错执行make clean make px4_fmu-v6x_default3.3 固件烧录通过USB连接Pixhawk后执行make px4_fmu-v6x_default upload成功烧录后会显示Erase : [] 100.0% Program: [] 100.0% Verify : [] 100.0%4. 自定义模块开发与集成4.1 源码结构解析关键目录说明src/ ├── examples/ # 官方示例代码 ├── modules/ # 系统模块 └── drivers/ # 硬件驱动4.2 添加新功能模块以创建简单的状态指示灯模块为例在src/examples下新建led_controller目录创建led_controller.cpp实现模块逻辑在boards/px4/fmu-v6x/default.cmake中添加examples/led_controller4.3 编译验证重新编译后会看到新模块被包含[100%] Linking CXX executable px4_fmu-v6x_default.elf [100%] Built target led_controller5. 常见问题解决方案5.1 子模块更新失败典型错误fatal: clone of https://github.com/... failed解决方法删除卡住的子模块目录设置git代理或更换镜像源使用--jobs1降低并行下载数量5.2 内存不足错误编译Pixhawk 1FMUv2时可能出现region flash overflowed by 1234 bytes解决方案移除不必要模块使用make px4_fmu-v3_default替代5.3 地面站连接问题如果QGroundControl无法识别设备检查/dev/serial/by-id设备权限确保没有其他程序占用串口更新Pixhawk bootloader6. 进阶开发技巧6.1 使用VSCode开发安装扩展C/CCMake ToolsPX4-Autopilot配置settings.json{ cmake.configureArgs: [ -DCMAKE_BUILD_TYPEDebug, -DPX4_BOARDfmu-v6x ] }6.2 仿真测试启动Gazebo仿真make px4_sitl gz_x500支持多种仿真器jMAVSim轻量级Gazebo高精度AirSim视觉仿真6.3 性能优化启用ccache加速编译export CCACHE_DIR$HOME/.ccache ccache -M 5G使用多核编译make -j$(nproc) px4_fmu-v6x_default经过实际项目验证这套开发流程在Pixhawk 6X上运行稳定。记得在修改关键参数后务必进行充分的仿真测试再实际上机验证。
