1. 故障现象与排查思路总览1.1 两个错误码到底在说什么Labtools 27-2269 和 27-2270 是 Vivado 硬件管理器在尝试通过 JTAG 连接目标器件时抛出的经典错误组合。27-2269 的完整信息通常是 Cannot connect to the target device 或 Unable to detect the JTAG chain而 27-2270 则多表现为 The cable is not connected 或 JTAG chain detection failed。这两个错误经常成对出现本质上指向同一个问题域Vivado 的硬件服务器无法与下载器建立有效通信或者下载器无法与目标板上的 JTAG 链路握手。我经手过的案例里这两个错误码覆盖了从物理层到软件层的完整故障谱系。物理层可能是 USB 线松动、下载器供电不足、JTAG 排线接反链路层可能是 TDI/TDO 信号被其他器件拉死、JTAG 链上存在未知器件软件层则可能是驱动未正确安装、hw_server 进程卡死、或者 Vivado 版本与下载器固件不匹配。很多人一看到这两个错误就急着换线换板子实际上按照正确的排查顺序走大部分问题在十分钟内就能定位。1.2 排查顺序为什么不能乱我见过太多人一上来就重装 Vivado结果浪费半天时间发现只是 USB 线没插紧。正确的排查逻辑应该遵循从物理到逻辑、从底层到上层的原则。具体来说先确认 USB 连接和供电再检查驱动状态然后验证 JTAG 链的物理连通性接着排查 hw_server 的运行状态最后才考虑 Vivado 工程配置和器件兼容性问题。这个顺序背后的逻辑很简单越底层的故障影响面越大排查成本越低。你花三十秒检查一根 USB 线可能省下三个小时的重装时间。而且底层故障排除后上层问题的表现往往会发生变化这时候再针对性处理效率最高。1.3 一张速查表帮你快速定位排查层级检查项典型现象预计耗时物理层USB 线、JTAG 排线、供电设备管理器无识别1 分钟驱动层下载器驱动状态设备管理器有黄色感叹号3 分钟链路层JTAG 链拓扑、TDI/TDO能识别下载器但扫不到器件5 分钟服务层hw_server 进程连接超时或端口占用3 分钟工程层器件型号、约束文件能扫到器件但无法配置5 分钟这张表是我自己排障时用的精简版实际用起来比翻官方文档快得多。下面我会逐层展开把每个环节的原理、操作和坑点都讲透。2. 物理连接与供电最容易被忽视的环节2.1 USB 线和接口的隐性故障USB 线的问题远比想象中普遍。很多开发板附带的 USB 线是充电线而非数据线内部只有电源引脚没有数据引脚插上去设备管理器毫无反应。判断方法很简单换一根确认能传数据的线试试。另外 USB 3.0 接口和 USB 2.0 接口在某些下载器上表现不同Xilinx Platform Cable USB II 在 USB 3.0 接口上偶尔会出现枚举失败换到 USB 2.0 接口反而稳定。还有一个容易被忽略的点USB Hub 的供电能力。如果你把下载器插在一个没有独立供电的 Hub 上而 Hub 上还挂着其他大功率设备下载器可能因为供电不足而无法正常初始化。我实测过某品牌七口 Hub同时挂三个下载器时第三个必然报 27-2269单独插就没问题。所以排障时建议直接插主板后置 USB 口排除 Hub 干扰。2.2 JTAG 排线的接法与信号定义JTAG 排线接反是新手最常犯的错误。标准的 14 针 JTAG 接口2.54mm 间距引脚定义如下1 脚是 VREF参考电压2 脚是 TMS3 脚是 TDI4 脚是 TDO5 脚是 TCK6 脚是 GND其余引脚包括 TRST、SRST 等。如果你把排线反过来插VREF 和 GND 对调轻则扫不到器件重则烧毁下载器输出级。注意插拔 JTAG 排线前务必断开开发板电源热插拔可能导致下载器内部电平转换芯片损坏。判断排线是否接对的一个实用技巧用万用表测下载器侧 VREF 引脚对 GND 的电压正常应该是 3.3V 或 1.8V取决于目标板 IO 电压。如果测不到电压说明目标板没有给 VREF 供电或者排线断了。VREF 是下载器判断目标板 IO 电平标准的依据没有 VREF 下载器根本不会输出 JTAG 信号。2.3 目标板供电与 POR_B 信号有些板子 JTAG 接口的 VREF 是由目标板上的稳压器提供的如果目标板没上电VREF 就是 0V下载器自然无法工作。还有一种情况是目标板上了电但 POR_BPower-On Reset信号被拉低PL 端一直处于复位状态JTAG TAP 控制器不响应。热词里提到的 [labtools 27-3421] xczu47dr_0 pl power status off, cannot connect pl tap. check por_b signal 就是这类问题的典型表现。排查方法用示波器或万用表测 POR_B 信号正常应该是高电平通常 1.8V 或 3.3V。如果一直是低电平检查复位电路上的电容是否漏电、复位按键是否卡死、或者电源管理芯片是否正常输出。我遇到过一块板子因为复位电容焊反导致 POR_B 永远拉低换了电容立刻就能连上。3. 驱动安装与设备识别Windows 下的重灾区3.1 下载器驱动的正确安装姿势Vivado 安装时会自动安装 Xilinx 下载器驱动但这个过程经常出问题。最常见的是 Windows 驱动签名强制导致驱动安装失败设备管理器里下载器显示为未知设备或带黄色感叹号。解决办法是进入测试模式或临时禁用驱动签名强制然后手动指定驱动路径为Vivado安装目录\data\xicom\cable_drivers\nt64\。具体操作右键设备管理器中的未知设备选择更新驱动程序浏览到上述目录让系统自动搜索。如果系统提示已安装最佳驱动但仍然不工作说明驱动版本不匹配需要先卸载设备再重新扫描。卸载时勾选删除此设备的驱动程序软件然后重新插拔下载器。3.2 设备管理器里的正常状态长什么样安装正确的驱动后设备管理器里应该能看到两类设备一是 Xilinx USB Cable 或 Digilent USB Device取决于下载器品牌位于通用串行总线控制器或其他设备下二是可能出现的 USB Serial Converter 之类的复合设备。如果只看到未知设备说明驱动没装上如果看到设备但带感叹号说明驱动装上了但初始化失败通常是供电或固件问题。提示Digilent 系列的下载器如 HS2、HS3需要单独安装 Digilent Adept 运行时Vivado 自带的驱动不一定覆盖所有型号。去 Digilent 官网下载最新版 Adept 安装后设备管理器里应该出现 Digilent USB Device。3.3 驱动冲突与端口占用的排查有时候驱动装好了设备管理器也正常但 Vivado 就是连不上。这时候要检查是否有其他软件占用了下载器。常见的占用者包括Digilent Adept、ISE 的 iMPACT、其他版本的 Vivado hw_server、甚至某些串口调试工具。每个下载器同一时间只能被一个进程占用如果 hw_server 已经在后台运行新的连接请求会被拒绝。排查方法打开任务管理器结束所有hw_server.exe、impact.exe、adept.exe进程然后重新在 Vivado 里打开 Hardware Manager。如果还是不行用netstat -ano | findstr 3121检查 3121 端口hw_server 默认端口是否被占用找到占用进程 PID 后强制结束。4. JTAG 链拓扑与信号完整性4.1 链上器件识别失败的常见原因JTAG 链是一个串行移位寄存器链TDI 进 TDO 出所有器件串联。如果链上任何一个器件的 TDI/TDO 断路或者某个器件的 TCK/TMS 没有正确连接整条链都扫不到。Vivado 的 Open Target - Auto Connect 会尝试扫描链上所有器件如果返回空列表或只返回部分器件说明链路有问题。一个实用的排查手段是使用 Open Target - Open New Target 手动指定链拓扑。如果你知道链上有几个器件、每个器件的 IR 长度可以手动配置。但更常见的情况是链上有一个器件把 TDO 拉死了导致后续器件全部不可见。这时候需要逐个器件断开用二分法定位故障器件。4.2 TDI/TDO 信号被拉死的诊断TDO 被拉死是 JTAG 排障中最隐蔽的问题之一。正常工作时 TDO 应该由当前选中的器件驱动其他器件处于高阻态。但如果某个器件的 TDO 输出使能一直有效或者外部有上拉/下拉电阻配置不当TDO 线就会被固定在一个电平上导致扫描数据全错。诊断方法断开目标板电源用万用表测 TDO 对 GND 的电阻。正常应该是高阻几百千欧以上如果测到几十欧姆或短路说明有器件把 TDO 拉死了。逐个断开链上器件的 TDO 引脚直到找到罪魁祸首。我遇到过一块 Zynq 板子因为 PL 端某个 Bank 的 VCCO 没供电导致 IO 缓冲器状态异常把 TDO 拉低补上 VCCO 供电后问题消失。4.3 多器件链的配置与注意事项当链上有多个器件时Vivado 需要知道每个器件的 IR 长度和位置。自动扫描通常能处理标准配置但如果链上有非 Xilinx 器件比如某些 CPLD 或第三方芯片自动扫描可能失败。这时候需要在 Hardware Manager 里手动添加器件指定每个器件的 IR 长度。注意链上器件的顺序必须与物理连接顺序一致TDI 接第一个器件的 TDI第一个器件的 TDO 接第二个器件的 TDI以此类推最后一个器件的 TDO 接下载器的 TDO。多器件链还有一个坑如果某个器件处于复位状态或时钟未供给它的 TAP 控制器可能不响应导致整条链扫描失败。这时候可以尝试给该器件单独提供时钟或释放复位或者用 BYPASS 模式绕过它。5. hw_server 服务与软件层排查5.1 hw_server 的启动与端口配置Vivado 的硬件管理器依赖 hw_server 进程与下载器通信。hw_server 默认监听 3121 端口如果这个端口被防火墙拦截或已被其他进程占用Vivado 就会报连接失败。在 Windows 上hw_server 通常由 Vivado 自动启动但有时候会启动失败或卡死。手动启动 hw_server 的方法打开 Vivado 的 Tcl Console输入start_hw_server或open_hw_manager。如果自动启动失败可以在命令行里直接运行Vivado安装目录\bin\hw_server.bat观察输出信息。正常的启动日志会显示 Listening on port 3121 和 Discovered cable 之类的信息。如果卡在 Scanning cables 不动说明下载器枚举出了问题。5.2 连接超时与防火墙设置Windows 防火墙有时候会拦截 hw_server 的本地回环通信导致 Vivado 连不上自己启动的服务。表现是 Hardware Manager 一直显示 Connecting to hw_server 然后超时。解决办法是在防火墙里给 hw_server.exe 和 vivado.exe 添加例外或者临时关闭防火墙测试。另外如果你在远程连接 hw_server比如通过局域网连接另一台机器上的下载器需要确保 3121 端口在目标机器上开放并且 hw_server 启动时绑定了正确的网卡地址。默认情况下 hw_server 只监听 localhost远程连接需要在启动时加-s TCP::3121参数。5.3 Vivado 版本与下载器固件的兼容性Vivado 版本和下载器固件之间偶尔会有兼容性问题。比如某些老版本的 Platform Cable USB II 在 Vivado 2020.2 之后的版本上会出现枚举失败需要升级下载器固件。固件升级工具通常在Vivado安装目录\data\xicom\cable_drivers\下具体操作参考下载器厂商的说明。还有一种情况是 Vivado 的 Labtools 组件安装不完整。如果你在安装 Vivado 时只选了部分组件可能缺少某些下载器支持文件。检查方法在 Vivado 的 Help - About 里查看已安装的组件列表确认 Labtools 和 Hardware Server 都已安装。如果缺失通过 Vivado Installer 的 Add Design Tools or Devices 功能补装。6. 常见问题速查与独家避坑技巧6.1 典型问题与解决方案对照表问题现象可能原因解决方案设备管理器无下载器USB 线是充电线换数据线设备管理器有感叹号驱动未签名禁用驱动签名强制后重装能识别下载器但扫不到器件JTAG 排线接反检查引脚 1 位置扫到部分器件链上某器件 TDO 拉死二分法定位故障器件连接超时hw_server 未启动手动启动 hw_server端口占用多个 hw_server 实例结束所有 hw_server 进程能扫到但无法配置器件型号不匹配检查工程器件设置POR_B 一直低复位电路故障检查复位电容和按键6.2 我踩过的三个坑第一个坑USB 线太长导致信号衰减。我用过一根三米长的 USB 延长线下载器枚举时好时坏换了根一米的线立刻稳定。USB 2.0 规范建议线长不超过五米但实际使用中超过两米就可能出问题尤其是质量一般的线。第二个坑JTAG 排线的 VREF 引脚接触不良。排线插头用久了会松动VREF 时通时断表现是下载器偶尔能识别偶尔不能。用万用表测 VREF 电压时如果发现跳动换根排线或者用热熔胶固定插头。第三个坑Vivado 工程里的器件型号与实际板子不符。有一次我打开了一个别人给的工程器件设的是 xc7z020实际板子是 xc7z010Hardware Manager 能扫到器件但配置时一直报错。新建工程时务必确认器件型号与板子一致。6.3 一个提高排障效率的小习惯我习惯在每次连接硬件前先跑一遍检查脚本。在 Vivado 的 Tcl Console 里依次执行以下命令可以快速确认各环节状态# 检查 hw_server 状态 open_hw_manager connect_hw_server -url localhost:3121 # 列出已识别的下载器 current_hw_target get_hw_targets # 扫描 JTAG 链 open_hw_target current_hw_device get_hw_devices如果get_hw_targets返回空说明下载器没被识别问题在物理层或驱动层。如果返回了下载器但get_hw_devices为空说明 JTAG 链有问题。如果两者都正常但配置失败问题在工程设置或器件状态。这套流程走下来基本能在一分钟内定位故障层级。7. 特殊场景Zynq 与 UltraScale 的 JTAG 注意事项7.1 Zynq 器件的 PL 与 PS 独立 JTAGZynq 系列如 7020、7045的 PL 和 PS 有独立的 TAP 控制器但共享同一组 JTAG 引脚。默认情况下JTAG 链上会同时出现 PL TAP 和 PS TAP 两个器件。如果你只想配置 PL需要在 Hardware Manager 里选择对应的器件。有时候 PS 端处于复位状态会导致整个链扫描异常这时候可以尝试先只连接 PL TAP。热词里提到的 zynq 7020 使用 jtag 固化 flash 时必须使用 ddr 吗 这个问题答案是固化 flash 时 Vivado 需要把配置数据写入 flash这个过程不依赖 DDR但需要 PL 配置完成并且 flash 控制器可用。如果 DDR 未初始化不影响 flash 固化但可能影响某些依赖 DDR 的启动流程。7.2 UltraScale 的 POR_B 与电源状态UltraScale 器件如 xczu47dr对 POR_B 信号更敏感。如果 PL 端电源未就绪或 POR_B 未释放JTAG TAP 控制器不会响应报错就是 [labtools 27-3421] pl power status off, cannot connect pl tap。排查时先确认所有 PL 电源轨VCCINT、VCCAUX、VCCO都正常再测 POR_B 是否释放。注意UltraScale 的 POR_B 释放需要等待电源稳定和时钟就绪通常有几百毫秒的延迟。如果 POR_B 释放太早器件可能初始化失败。检查电源管理芯片的 POR 输出时序是否符合器件手册要求。7.3 固化 Flash 时的 JTAG 连接要点用 JTAG 固化 flash 时Vivado 会先通过 JTAG 配置 PL然后调用 flash 编程器写入数据。这个过程中 JTAG 连接必须保持稳定任何中断都会导致固化失败。建议固化时不要插拔其他 USB 设备避免 hw_server 被干扰。另外固化大容量 flash 时耗时较长确保电脑不要进入休眠状态。8. 从错误码到解决方案的完整实战记录8.1 一次典型的 27-2269 排障全过程上周同事拿来一块 Zynq 7020 板子说 Vivado 连不上报 27-2269。我按流程走了一遍先看设备管理器下载器识别正常换 USB 口无效检查 JTAG 排线发现插反了。反过来插上Auto Connect 立刻扫到了 PL 和 PS 两个器件。整个过程不到两分钟。这个案例说明大部分 27-2269 都是物理层问题先查线再查软件。8.2 一次 27-2270 的隐蔽故障另一次遇到 27-2270设备管理器正常排线也没接反但就是扫不到器件。用万用表测 TDO 对 GND 电阻发现只有 50 欧姆明显被拉死。逐个断开链上器件最后发现是一块 CPLD 的 TDO 引脚配置成了推挽输出且一直输出低电平。把 CPLD 的 TDO 配置改成高阻后问题解决。这个案例提醒我链上的非 Xilinx 器件也可能是故障源。8.3 软件层问题的排查记录还有一次是 hw_server 卡死Vivado 一直显示 Connecting to hw_server。任务管理器里看到三个 hw_server.exe 进程全部结束再重启 Vivado问题消失。后来分析原因是之前异常退出导致 hw_server 没有正常关闭新实例启动时端口冲突。现在我的习惯是每次关闭 Vivado 后检查一下 hw_server 是否残留有就手动结束。9. 预防性维护与日常使用建议9.1 下载器和排线的保养下载器和 JTAG 排线是易耗品日常使用注意几点插拔时捏住插头而不是拽线排线不要过度弯折尤其是靠近插头的位置长期不用时拔下下载器避免 USB 接口氧化。我自己的 Platform Cable USB II 用了五年多排线换过三根下载器本体一直正常。9.2 Vivado 环境的定期检查每隔几个月检查一次 Vivado 的驱动状态和 hw_server 版本。Vivado 升级后有时会覆盖旧驱动导致下载器识别异常。升级后第一次连接硬件时建议先跑一遍第 6.3 节的检查脚本确认各环节正常。另外保持 Vivado 的 Labtools 组件更新新版本通常会修复一些下载器兼容性问题。9.3 工程文件的规范管理工程里的器件型号、约束文件、JTAG 链配置建议单独记录在一个文本文件里换电脑或重装系统后可以快速恢复。我习惯在工程根目录放一个hardware_config.txt记录下载器型号、JTAG 链拓扑、器件 IR 长度等信息。这样即使自动扫描失败也能手动配置链拓扑快速恢复连接。10. 写在最后的一点个人体会JTAG 连接故障看起来吓人但拆开来看无非就是物理、驱动、链路、服务、工程五个层面。我排过的几百次故障里超过七成是物理层问题两成是驱动或服务问题真正需要深入分析链路拓扑的不到一成。所以下次再看到 27-2269 或 27-2270先别急着重装 Vivado花一分钟检查 USB 线和排线大概率就能解决。另外分享一个我最近发现的小技巧在 Vivado 的 Hardware Manager 里右键下载器选择 Close Target 再重新 Open Target有时候比直接 Auto Connect 更可靠。尤其是 hw_server 运行时间较长时重新打开目标可以刷新链路状态避免缓存导致的误报。这个操作在 Tcl 里对应close_hw_target和open_hw_target我把它加到了日常检查脚本里效果不错。