2. 环境搭建：OpenOCD的安装与驱动配置

说实话，环境搭建这一步，看着简单，但坑不少。我见过太多人卡在驱动上，折腾半天连不上调试器。咱们今天就把这事彻底理清楚。

2.1 安装OpenOCD

Linux下的安装

我个人习惯用源码编译，因为能拿到最新特性。但如果你图省事，包管理器也够用。

方式一：apt/yum 直接装

# Ubuntu/Debian
sudo apt-get install openocd

# Fedora/RHEL
sudo yum install openocd

方式二：源码编译（推荐）

为什么要编译？因为有些调试器需要特定驱动支持，比如FTDI的MPSSE模式。包管理器里的版本可能没开这些选项。

git clone https://git.code.sf.net/p/openocd/code openocd
cd openocd
./bootstrap
./configure --enable-ftdi --enable-stlink --enable-jlink
make -j$(nproc)
sudo make install

Windows下的安装

Windows 上我建议直接用预编译包。去 OpenOCD 官方 GitHub Release 下载 .exe 安装包就行。

装完后记得把安装目录加到 PATH 环境变量里。不然每次都要输全路径，烦得很。

# 验证安装
openocd --version

能看到版本号，说明装好了。

2.2 驱动配置

驱动这块，说白了就是让操作系统认识你的调试器。不同调试器，脾气不一样。

FTDI 调试器

FTDI 芯片的调试器（比如 FT2232H 做的 JTAG 适配器）在 Linux 下需要设置 udev 规则。不然每次都要 sudo，很烦。

# 创建 udev 规则文件
sudo nano /etc/udev/rules.d/99-ftdi.rules

# 写入以下内容
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6011", MODE="0666"

# 重新加载
sudo udevadm control --reload-rules
sudo udevadm trigger

Windows 下 FTDI 驱动比较简单。装个 Zadig 工具，把调试器切换到 WinUSB 驱动就行。我遇到过有人用默认驱动，结果 OpenOCD 死活认不到设备。

ST-Link

ST-Link 是 STM32 开发板自带的调试器。Linux 下同样需要 udev 规则。

# ST-Link udev 规则
SUBSYSTEM=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="3748", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="374b", MODE="0666"

Windows 下 ST-Link 驱动通常随 STM32CubeIDE 或 ST-Link Utility 一起安装。如果 OpenOCD 连不上，检查一下设备管理器里是不是显示为「STMicroelectronics STLink dongle」。

J-Link

J-Link 的驱动比较省心。SEGGER 官方提供了 J-Link Software Pack，装完就自带驱动了。

# Linux 下安装 J-Link 驱动
wget https://www.segger.com/downloads/jlink/JLink_Linux_x86_64.deb
sudo dpkg -i JLink_Linux_x86_64.deb

Windows 下直接下载安装包，一路 Next 就行。

2.3 环境验证

装完驱动，咱们得验证一下。不然心里没底。

验证调试器连接

用 OpenOCD 的 --list-interfaces 参数，看看能不能识别到调试器。

openocd --list-interfaces

如果输出里能看到你的调试器型号，比如 ftdi、stlink、jlink，说明驱动没问题。

验证目标板连接

找个开发板，接上调试器。用 OpenOCD 尝试连接。

# 以 STM32F4 为例
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg

看到类似下面的输出，就说明连上了：

Info : STLINK V2J29S7 (API v2) VID:PID 0483:3748
Info : Target voltage: 3.3V
Info : stm32f4x.cpu: hardware has 6 breakpoints, 4 watchpoints

2.4 知识结构总览

下面这张图，把整个环境搭建的脉络理清楚了。你照着走，不会迷路。

2.5 常见问题速查表