【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

特别要注意的是，必须移除可能干扰串口通信的modemmanager：

sudo apt-get remove modemmanager -y

1.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 --jobs=4

2. 依赖工具链安装

2.1 自动化安装脚本

PX4提供了便捷的环境配置脚本：

bash ./PX4-Autopilot/Tools/setup/ubuntu.sh

这个脚本会自动安装：

• ARM交叉编译工具链（gcc-arm-none-eabi）
• Python3开发环境
• Gazebo仿真器依赖
• 代码格式化工具

2.2 常见问题处理

如果脚本执行中出现网络超时，可以手动重试失败的部分。例如Python包安装失败时：

pip3 install --user numpy toml pandas jinja2 pyyaml

3. Pixhawk固件编译实战

3.1 选择编译目标

进入源码目录查看支持的硬件：

cd ~/px4_ws/src/PX4-Autopilot make list_config_targets | grep pixhawk

对于Pixhawk 6X硬件，应使用：

make px4_fmu-v6x_default

3.2 编译过程详解

完整编译会经历以下阶段：

1. CMake配置生成
2. 交叉编译NuttX系统
3. 编译PX4中间件
4. 链接生成最终固件

首次编译可能需要15-30分钟，后续增量编译只需1-2分钟。如果遇到ninja报错，执行：

make clean && make px4_fmu-v6x_default

3.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 添加新功能模块

以创建简单的状态指示灯模块为例：

1. 在src/examples下新建led_controller目录
2. 创建led_controller.cpp实现模块逻辑
3. 在boards/px4/fmu-v6x/default.cmake中添加：

examples/led_controller

4.3 编译验证

重新编译后会看到新模块被包含：

[100%] Linking CXX executable px4_fmu-v6x_default.elf [100%] Built target led_controller

5. 常见问题解决方案

5.1 子模块更新失败

典型错误：

fatal: clone of 'https://github.com/...' failed

解决方法：

1. 删除卡住的子模块目录
2. 设置git代理或更换镜像源
3. 使用--jobs=1降低并行下载数量

5.2 内存不足错误

编译Pixhawk 1（FMUv2）时可能出现：

region 'flash' overflowed by 1234 bytes

解决方案：

1. 移除不必要模块
2. 使用make px4_fmu-v3_default替代

5.3 地面站连接问题

如果QGroundControl无法识别设备：

1. 检查/dev/serial/by-id设备权限
2. 确保没有其他程序占用串口
3. 更新Pixhawk bootloader

6. 进阶开发技巧

6.1 使用VSCode开发

安装扩展：

• C/C++
• CMake Tools
• PX4-Autopilot

配置settings.json：

{ "cmake.configureArgs": [ "-DCMAKE_BUILD_TYPE=Debug", "-DPX4_BOARD=fmu-v6x" ] }

6.2 仿真测试

启动Gazebo仿真：

make px4_sitl gz_x500

支持多种仿真器：

• jMAVSim（轻量级）
• Gazebo（高精度）
• AirSim（视觉仿真）

6.3 性能优化

1. 启用ccache加速编译：

export CCACHE_DIR="$HOME/.ccache" ccache -M 5G

2. 使用多核编译：

make -j$(nproc) px4_fmu-v6x_default

经过实际项目验证，这套开发流程在Pixhawk 6X上运行稳定。记得在修改关键参数后，务必进行充分的仿真测试再实际上机验证。