4. 接口配置（Interface）：常见调试器的配置方法
接口配置，说白了就是告诉 OpenOCD：「你的调试器长什么样，怎么跟它说话」。这一步要是配错了，后面所有调试工作都白搭。我见过不少工程师花一整天排查连接问题，最后发现只是接口配置文件里少了个参数。
OpenOCD 支持多种调试器，每种都有自己的脾气。咱们一个个来看。
4.1 FTDI 调试器配置
FTDI 芯片（比如 FT2232H、FT232H）是很多自制调试器的核心。OpenOCD 通过 libftdi 或 ftd2xx 驱动跟它通信。
先看一个典型的 FT2232H 配置：
# interface/ftdi/olimex-arm-usb-tiny-h.cfg
interface ftdi
ftdi_device_desc "Olimex OpenOCD JTAG ARM-USB-TINY-H"
ftdi_vid_pid 0x15ba 0x002a
ftdi_layout_init 0x0808 0x0a1b
ftdi_layout_signal nTRST -data 0x0200
ftdi_layout_signal nSRST -data 0x0100
这里有几个关键点：
- VID/PID：必须跟你的设备匹配。用
lsusb（Linux）或设备管理器（Windows）查一下。 - ftdi_layout_init：定义 GPIO 引脚的初始状态。两个十六进制数分别代表低字节和高字节的初始值。
- ftdi_layout_signal：把 OpenOCD 的信号（nTRST、nSRST、TCK、TDI 等）映射到 FTDI 的 GPIO 上。
openocd -f interface/ftdi/xxx.cfg -c "ftdi_layout_list" 看看当前 GPIO 状态。这能帮你快速确认硬件连接对不对。
4.2 ST-Link 调试器配置
ST-Link 是 STM32 开发板上的标配。OpenOCD 对它的支持已经很成熟了。
# interface/stlink.cfg
interface hla
hla_layout stlink
hla_device_desc "ST-Link"
hla_vid_pid 0x0483 0x3748
注意这里用的是 interface hla（High Level Adapter），不是 interface ftdi。ST-Link 有自己的协议栈，OpenOCD 通过 HLA 驱动跟它交互。
| ST-Link 版本 | VID:PID | 支持模式 |
|---|---|---|
| ST-Link/V2 | 0x0483:0x3748 | SWD, JTAG |
| ST-Link/V2-1 | 0x0483:0x374b | SWD, JTAG, VCP |
| ST-Link/V3 | 0x0483:0x374f | SWD, JTAG, SWO |
4.3 J-Link 调试器配置
J-Link 是 Segger 家的产品，性能稳定，但配置上有点小讲究。
# interface/jlink.cfg
interface jlink
jlink_device_desc "J-Link"
jlink_vid_pid 0x1366 0x0101
J-Link 的配置相对简单，但有个关键参数容易被忽略——传输速率：
# 在配置文件中设置
adapter speed 4000
# 或者在命令行临时调整
openocd -f interface/jlink.cfg -c "adapter speed 1000"
速率设太高，信号容易失真；设太低，调试体验很差。我个人建议从 1000 kHz 开始试，稳定后再往上加。
J-Link 的隐藏功能：它支持虚拟串口（VCP）和 RTT（Real-Time Transfer）。在配置里加上 jlink serial <你的序列号>，可以锁定特定设备，避免多台 J-Link 同时插着时搞混。
4.4 ULink 调试器配置
ULink 是 ARM/Keil 生态里的调试器。OpenOCD 对它的支持是通过 CMSIS-DAP 协议实现的。
# interface/cmsis-dap.cfg
interface cmsis-dap
cmsis_dap_vid_pid 0x0d28 0x0204
cmsis_dap_serial "1234567890"
ULink2 和 ULink Pro 的 VID/PID 不一样，查一下官方文档确认。另外，ULink 的 SWO 引脚可以用来输出调试信息，配置方法如下：
# 启用 SWO
cmsis_dap_swo_enabled 1
cmsis_dap_swo_frequency 2000000
4.5 自定义接口配置
有时候你手头没有现成的配置文件，或者你做了个自己的调试器板子。这时候就得自己写接口配置了。
自定义配置的核心是搞清楚三件事：
- 硬件连接：调试器的哪些引脚对应 JTAG/SWD 的哪些信号。
- 驱动类型：FTDI、HLA、CMSIS-DAP 还是其他。
- 时序参数：时钟频率、信号延迟等。
下面是一个基于 FT232H 的自定义配置示例：
# custom_ft232h.cfg
interface ftdi
ftdi_device_desc "Single RS232-HS"
ftdi_vid_pid 0x0403 0x6014
# 引脚映射（根据你的硬件设计调整）
ftdi_layout_init 0x0008 0x000b
ftdi_layout_signal nTRST -data 0x0010
ftdi_layout_signal nSRST -data 0x0020
ftdi_layout_signal TCK -data 0x0001
ftdi_layout_signal TDI -data 0x0002
ftdi_layout_signal TDO -data 0x0004
ftdi_layout_signal TMS -data 0x0008
# 设置传输速率
adapter speed 500
openocd -f your_config.cfg -c "adapter assert" 检查信号电平是否正确。再用逻辑分析仪抓一下 TCK/TMS/TDI/TDO 的波形，确认时序没问题。
4.6 接口配置知识图谱
下面这张图帮你理清接口配置的整体逻辑：
4.7 接口配置的通用排查思路
配置写好了，但 OpenOCD 就是连不上？别急，按这个顺序查：
- 检查 USB 设备：
lsusb或设备管理器里能看到你的调试器吗？ - 确认 VID/PID：配置文件里的 VID/PID 跟实际设备一致吗？
- 检查驱动：Windows 下需要安装 WinUSB 或 libusb 驱动。Linux 下可能需要 udev 规则。
- 降低速率：把
adapter speed降到 100 kHz，排除信号质量问题。 - 查看日志：OpenOCD 启动时加
-d参数，看详细输出。
接口配置是 OpenOCD 调试的第一步，也是最容易出问题的一步。把上面这些调试器的配置方法吃透，再遇到连接问题，你心里就有底了。