2. JTAG 信号与接口：核心信号与常见连接器详解
JTAG（Joint Test Action Group）接口最初是为 PCB 边界扫描测试而设计，如今已成为嵌入式调试的事实标准。理解 JTAG 的五条核心信号线以及不同物理连接器的引脚定义，是搭建 OpenOCD 调试环境、排查连接故障的基础。
2.1 五条核心 JTAG 信号线
标准的 JTAG 接口包含 TCK、TMS、TDI、TDO 和可选的 TRST 信号。每条信号线在调试链路中承担特定角色，下表总结了它们的名称、方向与功能。
| 信号 | 全称 | 方向（调试器→目标） | 功能简述 |
|---|---|---|---|
| TCK | Test Clock | 输出 | 提供同步时钟，所有 JTAG 操作在 TCK 上升沿或下降沿采样 |
| TMS | Test Mode Select | 输出 | 控制 TAP（Test Access Port）状态机的状态跳转 |
| TDI | Test Data In | 输出 | 将指令或数据串行移入目标芯片的 TAP 控制器 |
| TDO | Test Data Out | 输入 | 从目标芯片串行读出响应数据或状态 |
| TRST | Test Reset | 输出 | （可选）异步复位 TAP 控制器，强制回到 Test-Logic-Reset 状态 |
调试经验： 在高速调试（如 10 MHz 以上）时，TCK 的波形质量直接影响 TDO 数据采样的正确性。建议在 TCK 与 TDO 之间保持等长布线，并避免在 JTAG 链路过长时使用过高的时钟频率。
2.2 TAP 状态机与信号协同
JTAG 的核心是一个 16 状态的有限状态机，称为 TAP 控制器。TCK 提供时钟节拍，TMS 在 TCK 上升沿被采样，决定状态机的下一个状态。TDI 和 TDO 则在特定的移位状态（Shift-IR / Shift-DR）下完成数据串行传输。
关键理解： 调试器通过 TMS 在 TCK 的每个上升沿驱动状态机。例如，连续 5 个 TCK 上升沿保持 TMS=1，无论当前状态如何，都会强制回到 Test-Logic-Reset 状态。这是初始化 JTAG 链路的常用方法。
2.3 常见 JTAG 连接器引脚定义
嵌入式开发板上最常见的 JTAG 连接器有 20-pin (ARM 标准)、14-pin (TI / 旧式 ARM) 和 10-pin (Cortex-M SWD 兼容) 三种。下表列出各连接器与核心 JTAG 信号对应的引脚号。
| 信号 | 20-pin (ARM) | 14-pin (TI) | 10-pin (Cortex-M) |
|---|---|---|---|
| TCK | 9 | 1 | 9 |
| TMS | 7 | 3 | 7 |
| TDI | 5 | 5 | 5 |
| TDO | 13 | 9 | 13 |
| TRST | 3 | 2 | — |
| GND | 4, 6, 8, 10, 12, 14, 16, 18, 20 | 4, 6, 8, 10, 12, 14 | 4, 6, 8, 10, 12, 14 |
| Vref (目标参考电压) | 1 | — | 1 |
接线警告： 20-pin 连接器的引脚 2 通常为 Vsupply（目标板电源），但部分调试器将此引脚作为 VTref 检测脚。错误的接线可能导致调试器误判目标电压，甚至烧毁调试器接口。连接前务必核对调试器与目标板的引脚定义。
2.4 连接器物理形态与适配
三种连接器在物理上互不兼容，但通过转接板或杜邦线可以互连。下图展示了三种连接器的引脚排列（俯视图，缺口朝上）。
2.5 信号时序与电气特性
JTAG 信号在高速调试时对时序有明确要求。以下列出 OpenOCD 调试中常见的时序参数与电气特性。
- TCK 频率： 通常为 1 kHz ~ 50 MHz，取决于目标芯片与布线长度。OpenOCD 中通过
adapter speed命令设置。 - 建立/保持时间： TMS、TDI 必须在 TCK 上升沿之前建立并保持一段时间，典型值为 5 ns ~ 20 ns。
- 输出延迟： TDO 在 TCK 下降沿之后有效，延迟时间通常为 10 ns ~ 30 ns。
- 上拉/下拉： 建议在 TMS、TDI、TCK 上连接 10 kΩ 上拉电阻至 Vref，TDO 可悬空或下拉。
OpenOCD 配置示例： 设置 JTAG 时钟为 4 MHz，使用 20-pin 连接器。
# 在 openocd.cfg 中配置
source [find interface/jlink.cfg]
transport select jtag
adapter speed 4000
jtag newtap mychip cpu -irlen 4 -expected-id 0x4ba004772.6 常见连接故障与排查
在搭建 JTAG 调试环境时，信号连接问题是最常见的故障来源。下表列出典型症状与排查方向。
| 症状 | 可能原因 | 排查步骤 |
|---|---|---|
| OpenOCD 报告 "JTAG scan chain interrogation failed" | TDO 信号未正确连接，或目标芯片未上电 | 1. 用万用表测量 TDO 引脚对 GND 电压 2. 检查目标板供电与复位状态 |
| 检测到错误的 IDCODE | TDI/TDO 链路中存在虚焊或信号串扰 | 1. 降低 TCK 频率至 100 kHz 重试 2. 检查 JTAG 连接器是否插反 |
| 调试器无法识别目标电压 | VTref 引脚未连接或电压超出范围 | 1. 测量 VTref 引脚电压（应为 1.2V ~ 3.6V） 2. 确认调试器支持目标电压 |
| 偶尔连接成功，但调试中频繁断开 | TCK 信号质量差，或接地不良 | 1. 使用示波器观察 TCK 波形 2. 增加 GND 连接线数量 |
快速验证： 在 OpenOCD 中使用
jtag init 和 scan_chain 命令可以快速检测 JTAG 链路是否正常。如果返回的 IDCODE 与预期一致，说明 TCK、TMS、TDI、TDO 四线连接正确。