J-Link 调试器 安装、接线与环境要求
二、安装、接线与环境要求
装软件包
- 到 SEGGER 官网下载对应平台的 J-Link Software and Control Pack（Windows / Linux / macOS）。安装包里已经包含 J-Link Commander（
JLinkExe / JLink.exe）、J-Flash、J-Link GDB Server、RTT Viewer、Ozone 等工具。
- Windows 上装完会自动安装 USB 驱动；Linux 上需要装 udev 规则，否则普通用户没有权限访问设备。
- macOS 上首次运行需要在系统设置里允许来自该开发者的内核扩展或隐私授权。
- 装完先跑一次命令行工具确认版本：
JLinkExe -? 能打印帮助就说明安装正常。
Linux 下的 udev 规则文件通常放在 /etc/udev/rules.d/99-jlink.rules，内容由安装包提供或从官网文档获取；写好之后需要重新加载规则并把用户加入相应用户组，否则会出现「设备被识别但打不开」的现象。
sudo cp 99-jlink.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger
groups $USER
接线表
| J-Link 引脚 | 目标板 | 是否必需 | 说明 |
|---|
| VTref | 目标板 IO 电源（如 3.3 V） | 必需 | 不接会报目标电压检测失败，或探针输出电压判断错误 |
| GND | 目标板地 | 必需 | 建议至少两根地线，降低回流阻抗 |
| SWDIO | 目标 SWDIO（常与 JTAG 的 TMS 复用） | 必需 | 线尽量短，超过 10 到 15 cm 时把速度降下来 |
| SWCLK | 目标 SWCLK | 必需 | 旁边最好有地线伴行 |
| nRESET | 目标复位 | 建议 | 不做硬件复位也能连，但 connect under reset 必须要它 |
| SWO | 目标 SWO / TRACESWO | 可选 | 用 ITM 打印时才需要；用 RTT 则不需要 |
| 5V / 3.3V 供电输出 | 目标板电源 | 可选 | 只在目标板功耗很小时使用，务必确认电流上限 |
接线前先确认目标板已经上电，且调试引脚没有被固件复用成普通 GPIO、没有被外部电路强拉。引脚被复用是最常见的「连不上」原因。
常见报错排查
| 报错 | 可能原因 | 处理 |
|---|
| Cannot connect to target | 目标未上电、VTref 没接、SWD 引脚被复用、速度太高 | 确认供电与接线，把接口速度降到 1000 kHz 以下重试 |
| Could not find core in Coresight setup | 芯片处于复位、低功耗或调试端口被关 | 改用 connect under reset，把 nRESET 接上 |
| Failed to power up DAP | 供电不足或地线不良 | 检查目标电源与地线数量，避免从探针取电驱动整板 |
| 提示固件需要更新 | 软件包版本比探针固件新 | 按提示升级固件；升级过程中不要拔线 |
| 目标电压过低 / VTref 检测异常 | VTref 接到了 1.8 V 而目标 IO 是 3.3 V，或没接 | 把 VTref 接到目标 IO 域的实际电压 |
| 能连上但下载总失败 | Flash 有读保护、芯片型号选错、时钟配置导致擦写超时 | 先整片擦除，确认 device 名称与容量后缀一致 |
| 多个探针时连错设备 | 同时插了多个 J-Link | 用序列号选择：命令行加 -SelectEmuBySN |
