2、硬件连接排查：USB线缆质量与长度、接口接触不良、杜邦线/排线松动、JTAG/SWD信号线顺序核对
烧录失败，十有八九是硬件连接的问题。这不是夸张，是我这些年带项目、救火总结出来的血泪教训。很多工程师一上来就怀疑芯片、怀疑软件，折腾半天，最后发现就是一根线没插紧。
这一节，咱们就把硬件连接这块掰开揉碎讲清楚。你按这个顺序排查，能省下至少一半的调试时间。
2.1 USB线缆：最容易被忽视的“隐形杀手”
先说说USB线。你可能觉得，线嘛，能通电就行。但烧录对信号质量的要求，比单纯供电高得多。
核心指标：USB 2.0 高速模式（480 Mbps）对线缆阻抗有严格要求——差分阻抗 90Ω ±15%。劣质线缆的阻抗偏差可能超过 50%，直接导致信号眼图闭合。
我在项目中遇到过好几次：用一根 2 米长的普通手机充电线，死活连不上调试器。换成 0.5 米的品牌数据线，一次成功。为什么会这样？
线越长，信号衰减越严重。USB 2.0 的推荐长度上限是 5 米，但那是针对标准线缆。市面上很多线，尤其是那种“九块九包邮”的，铜芯细、屏蔽差，1 米以上就开始丢包。
| 线缆类型 | 推荐长度 | 典型问题 | 我的建议 |
|---|---|---|---|
| USB 2.0 数据线（品牌） | ≤ 1.5 米 | 基本无问题 | 首选，用于调试器 |
| USB 2.0 数据线（杂牌） | ≤ 0.5 米 | 阻抗不稳、供电不足 | 建议淘汰，或仅用于充电 |
| USB 延长线 | ≤ 1 米 | 增加接触点、信号衰减 | 尽量避免使用 |
| USB 3.0 数据线（向下兼容） | ≤ 2 米 | 兼容性偶有问题 | 可用，但需测试 |
小技巧：用手弯折线缆两端接口附近，如果烧录状态时断时续，说明线缆内部已经断裂。直接换新，别犹豫。
2.2 接口接触不良：最隐蔽的“软故障”
USB 接口、调试器接口、目标板接口——这三个地方，每一个都可能成为故障点。
我见过最离谱的一次：工程师折腾了三天，换了三块板子、两个调试器，最后发现是电脑的 USB 口里塞了一团灰尘。清理之后，一切正常。
排查接口接触不良，我有个“三板斧”：
- 目视检查：看接口有没有变形、氧化、异物。特别是那种经常插拔的接口，簧片容易疲劳。
- 替换测试：换一个 USB 口，换一台电脑。如果问题消失，那就是原接口的问题。
- 按压测试：在烧录过程中，用手指轻轻按压接口或线缆插头。如果烧录状态变化，说明接触不良。
警告：不要用“吹气”的方式清理接口。唾液中的水分会加速氧化。用无水酒精 + 无尘布，或者专用的电子清洁剂。
2.3 杜邦线/排线：开发阶段的“万恶之源”
说实话，我个人最讨厌杜邦线。它方便是方便，但可靠性太差了。在原型开发阶段，杜邦线是必要的妥协。但你要知道它的弱点：
- 母座松动：插拔几次之后，母座的弹性就下降了，接触电阻变大。
- 线芯断裂：杜邦线的线芯很细，弯折几次就可能断在绝缘皮里面，外表看不出来。
- 相邻短路：如果杜邦线没有完全插到底，裸露的金属部分可能碰到相邻的针脚。
我曾经有一个项目，用杜邦线连接 ST-Link 和 STM32 板子。烧录成功率只有 60%，时好时坏。后来我把所有杜邦线换成了一根 10 针的排线，成功率直接升到 100%。
排线比杜邦线可靠得多，因为：
- 所有信号线被固定在一起，不会松动。
- 有防呆设计，不容易插反。
- 接触面积大，阻抗更稳定。
我的原则：能用排线，不用杜邦线。如果必须用杜邦线，每次插拔后都做一次通断测试。
2.4 JTAG/SWD 信号线顺序：错一根就全完
这是新手最容易犯的错误，也是老手偶尔会翻车的地方。JTAG 和 SWD 的信号线顺序，不同调试器、不同目标板，定义可能完全不同。
先看标准定义：
| 信号 | JTAG 功能 | SWD 功能 | 典型颜色（CMSIS-DAP） |
|---|---|---|---|
| VCC | 目标板供电（可选） | 目标板供电（可选） | 红色 |
| GND | 地 | 地 | 黑色 |
| SWDIO / TMS | TMS（模式选择） | SWDIO（数据 I/O） | 黄色 |
| SWCLK / TCK | TCK（时钟） | SWCLK（时钟） | 绿色 |
| nSRST | 目标复位（可选） | 目标复位（可选） | 紫色 |
| SWO / TDO | TDO（数据输出） | SWO（调试输出，可选） | 蓝色 |
注意，这只是最常见的定义。不同厂家的调试器，比如 J-Link、ST-Link、DAP-Link，它们的引脚排列可能完全不同。你想想看，如果把 SWDIO 和 SWCLK 接反了，调试器能正常工作吗？肯定不能。
我建议你每次连接前，都做一件事：核对原理图。找到调试器接口的原理图，再找到目标板调试接口的原理图，一根一根地对。
避坑指南：我曾经在项目交付前夜，发现烧录失败。排查了 2 个小时，最后发现是排线插反了——1 号引脚对到了 10 号引脚。从那以后，我每次都会在排线上用记号笔标出 1 号引脚的位置。
2.5 知识体系：硬件连接排查流程图
下面这张图，是我自己总结的排查流程。你照着走一遍，90% 的硬件连接问题都能解决。
这张图的核心逻辑是：从源头（USB 线缆）开始，一步一步往目标板方向排查。每检查完一步，就尝试烧录一次。如果问题还在，再走下一步。不要跳步，不要凭感觉。
嗯，硬件连接排查就讲到这里。记住一句话：先看线，再看口，最后看顺序。这九个字，能帮你解决大部分烧录失败的硬件问题。