第二章 开发环境搭建：Ubuntu下PX4源码编译、Eclipse/VSCode调试环境配置、JTAG/SWD调试器使用

说实话，搭建开发环境这事儿，看着简单，但坑是真不少。我见过太多新手在环境配置上卡了一整天，最后连个固件都编译不过。这一章，我就把这些年踩过的坑、总结的经验，一次性给你讲透。

2.1 Ubuntu下的PX4源码编译

先说说操作系统。我个人习惯用Ubuntu 20.04 LTS，稳定，兼容性好。Ubuntu 22.04也能用，但有些依赖包需要手动处理。你想想看，如果系统本身就不稳定，后面调试起来得多糟心？

2.1.1 基础依赖安装

别急着下载源码。先把基础环境搞定。我建议你按这个顺序来：

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装基础编译工具
sudo apt install -y \
    git \
    cmake \
    ninja-build \
    python3-pip \
    python3-venv \
    gcc-arm-none-eabi \
    gdb-multiarch

# 安装PX4专用依赖
sudo apt install -y \
    libxml2-dev \
    libxslt1-dev \
    libssl-dev \
    libudev-dev \
    libgstreamer1.0-dev \
    libgstreamer-plugins-base1.0-dev

2.1.2 编译PX4固件

源码下载后，编译其实就一条命令。但这里有个坑——编译参数的选择。我曾经在项目中遇到过，默认编译参数下固件体积太大，导致Flash装不下。后来才发现，需要根据具体硬件平台选择编译目标。

# 克隆源码
git clone https://github.com/PX4/PX4-Autopilot.git --recursive
cd PX4-Autopilot

# 编译px4_fmu-v5（Pixhawk 4）
make px4_fmu-v5_default

# 编译带调试信息的版本
make px4_fmu-v5_default DEBUG=1

# 编译并上传
make px4_fmu-v5_default upload

2.2 Eclipse/VSCode调试环境配置

说到IDE，我个人更偏爱VSCode，轻量、插件丰富。但Eclipse在嵌入式调试方面也有它的优势。我两个都用过，给你说说各自的优缺点。

2.2.1 VSCode配置

VSCode配置PX4调试环境，核心就是几个插件和配置文件。我建议你按这个步骤来：

1. 安装插件：C/C++、Cortex-Debug、CMake Tools
2. 配置launch.json：指定调试器类型和接口
3. 配置tasks.json：定义编译任务

// .vscode/launch.json 示例
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "PX4 Debug",
            "type": "cortex-debug",
            "request": "launch",
            "servertype": "openocd",
            "cwd": "${workspaceRoot}",
            "executable": "./build/px4_fmu-v5_default/src/firmware/px4_fmu-v5_default.elf",
            "device": "STM32F765",
            "configFiles": [
                "interface/stlink-v2.cfg",
                "target/stm32f7x.cfg"
            ]
        }
    ]
}

2.2.2 Eclipse配置

Eclipse配置相对复杂一些，但它的调试视图更直观。我记得刚开始用Eclipse时，光配置交叉编译器就折腾了半天。后来发现，其实只需要在“C/C++ Build”设置里指定工具链路径就行。

# Eclipse交叉编译器路径设置
# Window -> Preferences -> C/C++ -> Build -> Environment
# 添加变量：
ARM_NONE_EABI_PATH = /usr/bin

2.3 JTAG/SWD调试器使用

调试器这块，我踩过的坑最多。JTAG和SWD，说白了就是两种调试接口。JTAG用5根线，SWD只用2根。对于PX4这种资源紧张的飞控板，我强烈建议用SWD——省引脚，而且速度不慢。

2.3.1 硬件连接

连接调试器时，有个很容易忽略的问题：电平匹配。我曾经用3.3V的调试器去连1.8V的芯片，结果烧了IO口。后来学乖了，每次连接前先查芯片手册。

调试器类型	接口	引脚数	适用场景
ST-Link	SWD	4	STM32系列
J-Link	JTAG/SWD	5/4	通用
Black Magic Probe	SWD	4	GDB原生调试

2.3.2 OpenOCD配置

OpenOCD是调试的核心工具。配置其实不复杂，但很多人被它的脚本语法吓到了。我给你一个最简配置：

# openocd.cfg
source [find interface/stlink-v2.cfg]
source [find target/stm32f7x.cfg]

# 设置SWD模式
transport select hla_swd

# 设置调试速度
adapter speed 1000

# 初始化
init
targets
reset halt

2.3.3 GDB调试实战

有了OpenOCD，GDB调试就水到渠成了。我常用的调试流程是这样的：

# 启动OpenOCD（新开终端）
openocd -f openocd.cfg

# 启动GDB（另一个终端）
gdb-multiarch build/px4_fmu-v5_default/src/firmware/px4_fmu-v5_default.elf

# 在GDB中连接目标
(gdb) target remote localhost:3333
(gdb) monitor reset halt
(gdb) load
(gdb) continue

2.4 知识体系总览

说了这么多，我把整个开发环境搭建的流程画了张图。你一看就明白了：

这张图把整个开发环境搭建的脉络理清楚了。你从源码编译开始，一步步往下走，遇到问题就回头看这张图，基本不会迷路。