PX4固件1.11.0：从zip源码到飞控烧录的完整实践

简介PX4 固件 v1.11.0 完整压缩包面向无人机、机器人与自主系统开发者提供开箱即用的飞行控制软件方案。包内预集成飞控、导航、传感器融合、MAVLink 通信等核心模块用户下载解压即可应用于 Pixhawk 等硬件平台省去手动拉取子模块与配置网络环境的流程。压缩包约 897.36MB共 21946 个文件以 C/C 源码.c、.h、.cpp、.hpp为主同时包含构建配置defconfig、cmake、makefile、消息定义msg、仿真模型sdf、world及 Python 工具脚本便于二次开发与调试分析。当前已有 1623 人学习下载适合需要升级固件、研究飞控源码或定制功能的 PX4 开发者和无人机爱好者。通过该包可系统了解 v1.11.0 的模块划分与编译体系辅助完成参数调优、外设适配及自主飞行功能扩展。 先说个有意思的事身边好几个朋友最近都在翻一个老文件——px4 firmware 1.11.0.zip。有人从旧硬盘里翻出来有人照着老教程在网上找下载还有人辛辛苦苦从 GitHub 上 clone 之后自己打了一个压缩包。文件名看起来平平无奇但里面装的其实是让无人机真正“飞起来”的魂。PX4 是现在开源无人机圈子里用的最广的自动驾驶仪固件之一支持多旋翼、固定翼、无人车这些载具。1.11.0是它在 2020 年前后的一个稳定版本而zip后缀意味着你手里拿到的多半是源码包或者某次编译的产物备份。问题就来了拿到这个文件之后接下来该干什么直接解压就能烧吗还是得先配环境、拉依赖、编译出真正能烧录的固件这篇博文就把这个文件名背后的整条链路拆开讲清楚——固件是什么、1.11.0 这个版本为什么到现在还有人用、开发环境怎么搭、源码怎么切到老版本、怎么编译成可烧录的 product 文件、怎么烧进飞控以及我在实际过程中踩过的那些坑。不管你是刚接触 PX4 的新手还是从新版本退回来看老代码的“回坑选手”这篇文章应该都能帮上忙。1. 为什么是 PX4 1.11.0一个 zip 文件名背后的版本选择1.1 固件到底是什么飞控主板内部的小宇宙先把术语说人话。Firmware 就是固件你可以把它理解成“写在硬件芯片里的系统程序”。就像手机出厂自带操作系统、家里的智能路由器自带管理后台一样飞控板上跑的也不是普通的单片机程序而是一整套实时操作系统加控制算法。PX4 官方固件里底层跑的是 NuttX 这个轻量级实时操作系统上面挂着传感器驱动、姿态解算、位置控制、导航逻辑、故障保护这些模块模块之间通过 uORB 消息总线通信。所以拿到一个px4 firmware 1.11.0.zip本质上是拿到了一整个飞控系统的“系统镜像源码”。它不是一段几百行的代码而是一个工程级的软件仓库。这也是为什么很多新手第一反应是“解压完怎么没看到 exe、怎么点不开”——因为固件的使用方式是编译、烧录不是双击运行。PX4 的开发基本都在 Linux 环境下完成官方支持的平台是 Ubuntu。如果你手头只有 Windows也不是完全不能做可以用虚拟机或者 WSL但我个人建议直接用双系统或者一台 Linux 机器后续不管是编译、串口烧录还是跑仿真都会省很多事。1.2 1.11.0 这个版本到底行不行先说结论能用的老版本。1.11.0 大概发布于 2020 年在当时算是一个承上启下的稳定版本。它不像更早的 1.8、1.9 那样连多旋翼位置控制都还在频繁调整也不像现在的 1.14、1.15 那样引入了大量新依赖、新架构和更复杂的工具链。对大多数学习者和科研用途来说1.11.0 处在一个非常微妙的平衡点稳定、资料多、硬件支持广。我整理了一张对比表方便你直观感受版本区间典型特点适合人群1.8 ~ 1.9模块结构古老很多接口和现在差异大老树莓派和早期 Pixhawk 资料多极度怀旧、硬件极其老化1.10 ~ 1.11多旋翼控制趋于成熟故障保护逻辑完善Gazebo 仿真生态稳定教程多学习 PX4 架构、做毕设、科研验证1.12 ~ 1.13引入较多内部重构一些模块改名硬件支持开始向新飞控集中需要新功能、尝鲜1.14工具链要求高依赖多ROS2 集成更紧密学习曲线陡做新项目、接 ROS2、生产级应用为什么现在还有很多人刻意找老版本很重要的一个原因是社区生态。2019 到 2021 年那段时间大量无人机比赛、毕设、开源项目都是基于 1.10 或者 1.11 做的网上搜“PX4 找不到位置估计”“PX4 定点抖动”“室内光流”这些问题答案几乎全是老版本的。你拿一个 1.11.0 去对这些答案基本能对上。真用最新版踩坑搜问题都没地方搜。另一个原因是官方源码仓库历史上经历过一次改名早期仓库叫PX4/Firmware后来改成了PX4/PX4-Autopilot。如果你现在搜索旧教程很多命令还是指向Firmware但 Git 会在访问时自动重定向并不影响 clone 历史版本。zip 文件里面可能来自不同渠道但拿到手之后先别急着解压搞清楚它是源码包还是编译产物才能决定下一步怎么做。2. PX4 1.11.0 环境搭建从零装出可编译的工具链2.1 方案选型Ubuntu 版本和工具链怎么挑PX4 1.11.0 年代官方主推的是 Ubuntu 18.04但实测 Ubuntu 20.04 也没问题前提是把依赖装对。我不建议用太新的系统比如 Ubuntu 22.04 之后再去编译 1.11.0会遇到 Python 版本、系统库和 GCC 工具链不兼容的问题排查起来很费劲。核心工具链包括几样git拉源码、切版本cmake和ninja-build构建系统arm-none-eabi-gcc交叉编译工具链负责把源码编译成飞控芯片能跑的二进制python3和一些 Python 包构建脚本和地面站工具会用到Gazebo如果跑仿真1.11.0 官方默认配的是 Gazebo 9在 Ubuntu 20.04 上装 Gazebo 11 也能跑但要注意个别兼容问题这里解释一下交叉编译的概念。飞控板上的主芯片比如 STM32F7和你的电脑 CPU 不是一个架构你不可能在电脑上直接运行飞控的二进制文件。交叉编译就是在电脑上生成一个“目标芯片能跑”的程序文件然后再烧录到飞控里。这个工具链版本很关键用错版本会导致编译报错或者生成的固件在飞控上跑不起来。2.2 依赖安装官方脚本和手动安装两条路PX4 1.11.0 的源码目录里带了一个自动化安装脚本Tools/setup/ubuntu.sh理论上你 clone 完仓库之后直接运行它就能装好大部分依赖。但这里有个坑这个脚本是针对 1.11.0 时代的 Ubuntu 18.04 写的如果你用 Ubuntu 20.04 甚至更高版本跑脚本里某些包名或者软件源地址会失效。建议操作方式是这样的sudo apt update sudo apt install -y git cmake ninja-build python3-pip \ build-essential pkg-config g # 安装 ARM 交叉编译工具链推荐 9-2020-q2-update 版本 # 从 ARM 官网下载 .tar.bz2 解压后加入 PATH工具链安装有个细节不要用sudo apt install gcc-arm-none-eabi直接装因为 Ubuntu 软件源里的工具链版本可能过老或过新编译 1.11.0 容易出问题。我实际用的是 Arm 官方发布的gcc-arm-none-eabi-9-2020-q2-update解压后在/etc/profile或者~/.bashrc里加一行export PATH$PATH:/opt/gcc-arm-none-eabi-9-2020-q2-update/bin安装完在终端里执行arm-none-eabi-gcc --version能看到版本号就说明工具链可用。这一步是后续所有编译的基础。2.3 环境验证清单工具链装好之后别急着 clone先浪费两分钟确认环境干净。检查项包括cmake --version能输出 3.16 以上版本ninja --version正常输出python3 --version在 3.6 到 3.8 之间arm-none-eabi-gcc --version能显示 ARM 工具链版本git --version正常。如果这些都没问题开发环境的软件层面基本就绪。另外还有一个容易忽略的就是串口权限。如果你准备烧录飞控需要把当前用户加入dialout用户组sudo usermod -a -G dialout $USER执行完要重新登录一次才生效否则后面烧录时系统会提示没有权限打开飞控串口。这是新手最常见也最容易卡住的点。3. 获取与编译固件的完整实操3.1 从源码仓库获取 1.11.0 并切换老版本源码获取最正规的方式还是 Git clone。命令很简单但你得注意一个事这个仓库很大尤其是带历史记录的情况下clone 可能会比较慢。建议用--recursive参数一次性把子模块也拉下来git clone --recursive https://github.com/PX4/PX4-Autopilot.git如果你网络环境不太好clone 过程中经常失败可以先等一等重试或者从国内镜像同步再或者直接下载 GitHub 对应 tag 的压缩包。不管用哪种方式拿到源码目录后先查看所有标签git tag | grep v1.11输出里会有v1.11.0、v1.11.2、v1.11.3这些版本号。要切换到你想要的版本执行git checkout v1.11.0 git submodule update --init --recursive第二步很关键因为 PX4 的源码里依赖了很多第三方子模块比如 NuttX、mavlink、uavcan 这些。只 checkout 主仓库而不更新子模块编译时会出现各种各样的“找不到头文件”“找不到模块”错误。这个坑我见过太多次了尤其是一些文章只教到git checkout就结束结果新手在编译阶段卡一整天。3.2 zip 包与源码仓库处理方式的取舍这里单独说说 zip 包。如果你手里的px4 firmware 1.11.0.zip是从 GitHub release 页面下载的Source code (zip)那么这只是一个源码快照里面不包含子模块。你需要解压、进入目录然后手动在目录里执行git init建一个本地仓库吗其实也可以不用 git直接在解压目录里跑构建指令前提是你得把子模块内容补齐。补齐子模块有一种土办法用上面的方式 clone 一份完整仓库切换到v1.11.0之后把解压出的源码覆盖到对应目录或者干脆不覆盖直接在 clone 出来的仓库上改代码。一般来说我建议直接 clone 而不是处理 zip 源码包因为子模块问题在 zip 方式下会把你折腾得很难受。另一种情况是这个 zip 本身就是朋友打包的编译产物——比如里面有build/px4_fmu-v5_default/px4_fmu-v5_default.px4这样的文件。那这个文件其实已经是最终固件了你可以直接用地面站 QGroundControlQGC的“固件更新”功能选择这个文件烧录。不过这种情况比较少大多数时候你拿到的还是源码包。3.3 编译目标选择和完整命令确定源码就位之后进入 PX4-Autopilot 目录执行编译命令。编译目标要对应你的飞控硬件型号不同型号使用不同的make目标飞控硬件make 目标说明Pixhawk 1px4_fmu-v2_default老一代Flash 空间小Pixhawk 2 / Pixhawk 1 升级版px4_fmu-v3_defaultCPU 性能尚可Pixhawk 4 / Pixhawk 4 Minipx4_fmu-v5_default我当时主要用的目标CUAV V5 / V5 nanopx4_fmu-v5_default兼容 v5 架构Holybro Durandalpx4_fmu-v5x_default部分版本需要支持以我常用的 Pixhawk 4 为例编译命令是cd PX4-Autopilot make px4_fmu-v5_default首次编译会花比较长时间20 到 40 分钟都正常因为它要先把 NuttX 系统、全部模块源码和驱动都编译一遍还有子模块里的中间件。编译过程会在终端里滚动输出大量日志看到[100%]和生成路径之后说明编译成功。产物路径通常是build/px4_fmu-v5_default/px4_fmu-v5_default.px4这个.px4文件就是最终烧录用的固件。整个编译过程还有个容易忽略的点源码目录路径不能有空格、不能有中文也尽量避免放在虚拟机共享目录里用拖拽方式操作否则编译会报一些莫名其妙的问题。4. 烧录、仿真、验证让固件真正跑起来4.1 硬件烧录完整流程如果你手里有飞控硬件可以跳过仿真直接烧录。第一步用 USB 线连接飞控上的 USB 口注意不是 TELEM 口。连接之后在终端确认设备ls /dev/ttyACM0如果提示没有这个设备试试/dev/ttyUSB0或者重新插拔。确认设备存在后执行上传命令make px4_fmu-v5_default upload这个命令会自动检测串口设备并烧录固件。烧录期间飞控上的 LED 会闪烁等待提示Reboot就说明烧录完成飞控会自动重启。如果遇到权限错误基本都是你没加入dialout用户组处理方法前面已经写过了。烧录完成后用 QGroundControl 地面站连接飞控能看到固件版本号、IMU 数据、传感器状态。这个时候先别急着起飞还要做传感器校准加速度计、陀螺仪、磁力计、水平校准一步步走完。4.2 没有硬件时用 Gazebo 仿真跑起来不是所有人都有飞控板学 PX4 完全可以用软件在环仿真SITL先跑起来。SITL 的意思是固件代码本身还是在电脑上运行只是把飞控的底层硬件用虚拟环境替代和仿真场景里的无人机模型对接。在 1.11.0 源码目录下执行make px4_sitl gazebo这个命令会先编译 PC 版固件然后自动启动 Gazebo 仿真环境加载一个默认多旋翼模型。看到 Gazebo 界面之后在终端里还可以输入命令控制解锁、起飞、降落这些操作。比如输入commander takeoff无人机模型就会起飞。仿真跑通之后你可以用 QGC 连接本地的仿真端口看实时状态和参数调试逻辑和调参和真机非常接近。这里要提醒一下1.11.0 的 Gazebo 配套默认是 Gazebo 9Ubuntu 20.04 的官方源默认是 Gazebo 11。如果你在启动仿真时卡在 Gazebo 界面加载不出来很可能是版本兼容问题。一个实用办法是让 Gazebo 运行时把模型库路径指向 PX4 的Tools/sitl_gazebo插件目录或者在启动前先单独加载一次 Gazebo 模型库。4.3 地面站连接与固件自检不管真机还是仿真QGroundControl 都是必装工具。烧录完成后用 QGC 连接时步骤如下先看右下角通信状态是不是绿色确认连接成功然后检查固件版本是否显示1.11.0接下来完成传感器校准也就是校准加速度计、陀螺仪、磁力计和水平面最后去参数列表里确认MAV_TYPE是不是多旋翼SYS_AUTOSTART是否对应你的机型配置。这些做完你就可以推动油门测试电机响应了。但第一次上电时要小心把螺旋桨拆掉再用地面站测试电机转向避免误操作伤人。5. 常见问题与排查技巧实录5.1 高频问题速查表这里把我在实际操作中遇到的、以及身边朋友问得最多的几个问题整理成一张速查表现象可能原因解决办法git clone时提示failed to connect或直接卡住网络波动、DNS 解析慢换网络环境重试、用镜像地址、延迟到凌晨再试解压 zip 包后编译报错找不到子模块zip 源码包不包含 submodule用git clone --recursive代替或手动git submodule update编译中报arm-none-eabi-gcc相关错误工具链版本过新或过老卸载系统自带工具链安装 9-2020-q2-update编译时提示找不到 CMakeLists 或 Ninja 错误源码路径含中文/空格、或构建缓存损坏把代码放到全英文路径make clean后重试烧录时提示could not open port /dev/ttyACM0用户没权限sudo usermod -a -G dialout $USER重新登录仿真启动卡在 Gazebo 加载界面Gazebo 版本与 1.11.0 不匹配核对 Gazebo 版本配置模型库路径解压 zip 时提示invalid zip archive: could not find EOCD压缩包下载不完整或损坏检查下载文件大小用 7-Zip 修复或重新下载烧录完连上 QGC 后传感器数据不动传感器校准未完成、或固件和硬件不匹配重新校准确认 make 目标与硬件一致5.2 排障思路和我个人的一点心得排障这件事最重要的是别慌。PX4 编译和烧录的错误百分之八十都是环境问题不是代码问题。看到屏幕上刷红色日志第一反应不应该是找代码原因而是回头看三样东西工具链版本对不对、子模块更新了没有、源码路径是不是干净。这三样只要有一个没对后面全都会炸。比如我身边一个朋友代码拿到了环境也是照着教程装的就是编译到一半总是报错而且报的还是同一个头文件找不到。最后排查了半天发现他把源码放在了一个带中文的目录下面cmake 解析路径直接崩了换成纯英文目录瞬间就好了。这种问题不踩一次你可能真想不到。另外如果你在网上下载到的是别人打包好的 zip 固件最好验证一下文件完整性比如对比文件大小、解压时不要跳过报错。我有一次就是图省事下载完一个 zip 直接解压结果解到一半提示文件损坏我当时没在意结果烧录进飞控之后飞控在解锁瞬间就不正常折腾了很久才发现是固件包本身不完整。关于那个zip的乱码问题如果解压后看到文件名变成乱码通常是因为压缩包用了非 UTF-8 编码比如韩文系统下做的压缩包。可以用 7-Zip 打开压缩包在选项里切换解压编码或者用在线工具重新转码一般能解决。最后再分享一个我后来一直在用的工作习惯每次编译固件之前先执行一次git submodule update --init --recursive花不了几分钟但能帮你躲掉大量“昨天还能编今天就不行”的灵异事件。还有Ubuntu 系统装完依赖之后最好把当前用户加到dialout组再重启一次电脑让所有环境变量都生效。很多时候你以为环境没装好其实就是没重新登录。PX4 1.11.0 这个版本放在今天来看确实不是最新的但在学习和研发上它反而是个很好的起点。代码结构清晰、资料齐全、生态成熟从它开始理解 PX4 的架构之后再迁移到新版本思路会顺很多。愿你把那个 zip 文件解压之后顺利编译出第一版属于自己的固件。本文还有配套的精品资源点击获取