1. PX4固件编译与烧录方法：课程介绍与前置准备

各位同学好，我是你们这门课的老王。在嵌入式飞控这个圈子里摸爬滚打了快十年，踩过的坑比飞过的航线还多。今天咱们开始聊PX4固件的编译与烧录，这是整个课程的第一章，也是你后续所有操作的基础。

说实话，很多新手一上来就急着敲命令、接飞控，结果环境没配好，编译报错一堆，烧录把板子搞成砖。我当年也干过这种事——记得第一次编译PX4，对着终端里满屏的红色报错，愣是盯了半小时没敢动。后来才发现，不过是少装了一个依赖包。

所以这一章，咱们把地基打牢。你跟着我走一遍，后面就顺了。

1.1 这门课到底讲什么？

先说说这门课的定位。它不是讲PX4怎么飞、怎么调参，也不是讲飞控算法怎么写。它聚焦在三个字上：编译、烧录、方法。

• 编译：把PX4的源码变成飞控板能跑的二进制文件。这里面涉及交叉编译链、CMake配置、固件裁剪。
• 烧录：把编译好的固件通过某种方式写进飞控板的Flash里。JTAG、SWD、USB、SD卡，各有各的玩法。
• 方法：不同场景下选哪种方式最稳、最快、最不容易翻车。这是经验活。

整门课30章，从环境搭建开始，到命令行编译、IDE编译、各种烧录方式、常见错误排查，最后还会讲CI/CD自动化。说白了，就是让你从「能编译」到「会编译」，从「能烧录」到「懂烧录」。

1.2 你需要准备什么？

工欲善其事，必先利其器。下面这些东西，我建议你在开始之前就准备好。别等到编译到一半发现缺这缺那，很扫兴。

1.2.1 硬件准备

硬件	推荐型号/规格	备注
飞控板	Pixhawk 4 / Holybro Pixhawk 6X / CUAV V5+	建议用主流板子，社区支持好
调试器	J-Link EDU / ST-Link V2 / Black Magic Probe	J-Link最稳，ST-Link性价比高
USB数据线	USB 3.0 Type-C / Micro-B	一定要用带屏蔽的数据线，别用充电线
电脑	Ubuntu 20.04/22.04 LTS 或 macOS 12+	Windows也能用，但坑多，我建议用Linux

嗯，这里要注意一点。调试器这块，很多人觉得用USB直接连飞控就能烧录，何必多花几百块买J-Link？我刚开始也这么想，直到有一次在项目现场，飞控死活连不上，换了三根线都不行。最后借了同事的J-Link，一次搞定。从那以后，我包里永远备着一个J-Link EDU Mini。

1.2.2 软件准备

软件方面，咱们后面几章会详细讲安装步骤。这里先列个清单，让你心里有数。

• 操作系统：Ubuntu 22.04 LTS（首选）或 macOS Ventura+
• 版本管理：Git（用于拉取PX4源码）
• 编译工具链：GCC ARM Embedded Toolchain（交叉编译器）
• 构建系统：CMake + Ninja 或 Make
• Python环境：Python 3.8+，用于运行PX4的辅助脚本
• 烧录工具：J-Link Commander / OpenOCD / dfu-util

1.3 知识体系概览

为了让你对整个课程有个全局认识，我画了一张图。这张图展示了PX4固件从源码到飞行的完整链路，以及咱们这门课覆盖的范围。

你看，整个流程其实不复杂。源码拉下来，配好环境，敲一条编译命令，再用调试器或者USB把固件写进去，最后连上地面站验证一下。但每个环节都有细节，细节决定成败。

1.4 常见问题与避坑指南

这一节我专门说说新手最容易翻车的地方。你提前知道，就能绕过去。

另外，还有几个常见问题：

• Git拉取失败：国内网络问题，建议配置代理或使用镜像源。我一般用 git clone https://github.com/PX4/PX4-Autopilot.git --recursive，如果慢就加个 -j4 参数并行拉取子模块。
• 编译报错找不到头文件：八成是子模块没拉全。运行 git submodule update --init --recursive 补一下。
• 烧录时连接失败：先检查驱动，再检查线缆。我遇到过好几次，换了根数据线就好了。记住，充电线不能传数据。

1.5 学习建议

最后，给你几条学习建议。这些是我自己带新人时总结出来的。

1. 别跳过环境搭建：很多人觉得装软件浪费时间，直接跳到编译。结果报错一堆，又回头补环境。一步到位反而最省时间。
2. 动手做笔记：每装一个工具，把命令和输出截图保存。下次重装系统或者换电脑，直接翻笔记，不用再搜一遍教程。
3. 准备一块备用板子：烧录有风险，操作不当可能把飞控板变砖。我建议你准备一块便宜的二手板子专门用来练习，等熟练了再用好板子。
4. 加入社区：PX4的Discourse论坛和GitHub Issues里有很多宝藏。遇到问题先搜，搜不到再问。提问时把日志贴全，别人才能帮你。