免电池多圈编码器：韦根效应如何实现断电记录百万圈
2026/9/28 7:23:59
1. 为什么SWD才是STM32日常调试的默认姿势
刚接触STM32的人，十有八九会在烧录这一步卡住。板子画好了，代码写完了，Keil5里点下Download，结果弹出一句“No ST-Link detected”或者“SWD/JTAG Communication Failure”，然后就开始怀疑人生——是驱动没装？是线接反了？还是芯片锁了？我见过太多人在这上面耗掉一整个下午，最后发现只是杜邦线太长导致信号完整性崩了。
这篇内容就是围绕Keil5 + ST-Link + SWD这套组合拳展开的。它不是什么高深技术，但绝对是每个STM32开发者绕不开的基本功。不管你是刚入门的电子专业学生，还是从51单片机转过来的老手，只要你想把代码真正跑进STM32芯片里，这套流程就得吃透。我会从接口选型、驱动安装、Keil5配置、烧录失败排查、批量生产几个维度，把这件事讲清楚，顺带把那些文档里不会写的坑一并交代了。
1.1 JTAG和SWD到底差在哪，为什么现在几乎没人用JTAG
STM32支持两种调试接口：JTAG和SWD。JTAG是老祖宗，20针的标准接口，能调试能边界扫描，功能全但占引脚。SWD是ARM后来推的串行调试接口，只要两根线——SWCLK和SWDIO，加上电源和地，四根线就能干活。
为什么现在SWD成了主流？三个原因。第一，引脚少。STM32的引脚本来就金贵，尤其是LQFP48这种小封装，JTAG占掉5个引脚（TCK、TMS、TDI、TDO、TRST），SWD只占2个，省下来的引脚可以拿去做串口、SPI、PWM。第二，SWD在高速下更稳。JTAG的并行信号在长排线上容易串扰，SWD是差分思路的串行传输，抗干扰能力强不少。第三，ST-Link V2和V3默认就只引出SWD接口，官方都在推，你跟着走就对了。
注意：SWD的SWCLK和SWDIO内部有上拉/下拉要求，PCB设计时别在这两根线上挂大电容，否则波形边沿变缓，高速烧录会失败。
实际接线就四根：ST-Link的3.3V接板子3.3V，GND接GND，SWCLK接PA14，SWDIO接PA13。STM32F103和F407的SWD引脚位置是一样的，PA13是SWDIO，PA14是SWCLK。有些板子会把这些引脚复用成普通GPIO，如果你在代码里把PA13、PA14配置成了输出，烧录时就会连不上——这是新手最容易踩的坑之一。
1.2 ST-Link V2、V3和板载调试器的选择逻辑
市面上常见的ST-Link有三种形态。第一种是淘宝十几块的ST-Link V2克隆版，蓝色铝合金外壳，用STM32F103C8做的主控。便宜是真便宜，但固件版本老，有些连STM32F4系列都识别不了，更别说G0、G4这些新片子。第二种是ST-Link V3，官方原厂，支持高速SWD，烧录大容量芯片时速度优势明显，还带虚拟串口和电源输出，价格大概两百多。第三种是Nucleo或Discovery板载的ST-Link，通过跳线帽把调试口引出来，质量稳定，适合学习阶段白嫖。
我的建议是：学习阶段用板载的或者V3，量产阶段用V2克隆版配离线烧录机。V2克隆版最大的问题是固件升级麻烦，ST官方工具会检测到克隆版然后拒绝升级，但日常烧录F1、F4系列够用了。如果你要调G0、L4这些低功耗系列，老老实实上V3。
| 型号 | 主控 | 支持芯片 | 烧录速度 | 价格区间 | 适用场景 |
|---|---|---|---|---|---|
| ST-Link V2克隆 | STM32F103C8 | F1/F4为主 | 中等 | 10-30元 | 学习、小批量 |
| ST-Link V3 | STM32F723 | 全系列 | 快 | 200-300元 | 开发、调试 |
| 板载ST-Link | 依板子而定 | 对应系列 | 中等 | 随板附赠 | 入门学习 |
2. 驱动安装：那些让你怀疑人生的识别问题
驱动这一步看似简单，但“ST-Link识别不到”是搜索量最高的STM32问题之一。Windows 10和Windows 11对未签名驱动的态度越来越严格，加上克隆版ST-Link的VID/PID可能被篡改，导致设备管理器里出现黄色感叹号。
2.1 官方驱动和STSW-LINK007的正确安装顺序
ST官方提供的驱动包叫STSW-LINK007，里面包含了ST-Link的USB驱动和固件升级工具。安装顺序很重要：先装驱动，再插设备。如果你先插了ST-Link，Windows可能会自动装一个不匹配的HID驱动，后面再装官方驱动就会冲突。
具体步骤：去ST官网下载STSW-LINK007，解压后运行dpinst_amd64.exe（64位系统）。装完后插入ST-Link，设备管理器里应该出现“STMicroelectronics STLink dongle”或者“STLink Virtual COM Port”。如果出现的是“未知USB设备”或者带感叹号的“STLink”，右键卸载设备，勾选“删除驱动程序软件”，拔掉重插，再手动指向STSW-LINK007的驱动目录。
提示：Windows 11下如果驱动签名验证失败，可以临时禁用驱动强制签名，但更稳妥的做法是找ST官方签过名的驱动版本，别用第三方修改版。
克隆版ST-Link有个经典问题：固件太老导致Keil5报“ST-Link firmware upgrade required”。这时候需要用ST-Link Utility或者STM32CubeProgrammer里的固件升级功能。但注意，克隆版升级固件有概率变砖，因为它的主控可能不是原装STM32F103，升级前最好确认一下。我个人的经验是，如果V2克隆版能正常烧录F103，就别手贱去升级固件。
2.2 设备管理器里的“未知USB设备”到底怎么破
“未知USB设备（设备描述符请求失败）”这个报错，九成是硬件问题，不是驱动问题。常见原因有三个：USB线是充电线不是数据线、ST-Link的USB口虚焊、电脑USB口供电不足。
先换一根确认能传数据的USB线，最好用带屏蔽的。然后换电脑后面的USB口，别用前面板或者USB Hub。如果还是不行，拆开ST-Link看看USB座子有没有脱焊，克隆版的做工参差不齐，USB座子受力后容易开焊。用万用表量一下D+和D-的对地阻值，正常应该在几十千欧级别，如果短路就是主控挂了。
还有一种情况是ST-Link的固件损坏，设备管理器里能看到设备但Keil5连不上。这时候用STM32CubeProgrammer的“Firmware upgrade”功能重新刷固件，如果刷不进去，基本可以换新的了。
3. Keil5工程配置：从Target到Debug的完整链路
Keil5的配置项多且分散，很多人烧录失败是因为某个选项没勾对。这一章把从新建工程到成功烧录的配置链路捋一遍，重点讲那些容易忽略的细节。
3.1 芯片包安装与Device选型
Keil5 MDK本身不带STM32的芯片包，需要单独安装STM32F1xx_DFP、STM32F4xx_DFP这些Device Family Pack。芯片包可以从Keil官网下载，也可以从ST官网找。安装方式有两种：双击.pack文件自动安装，或者在Keil5的Pack Installer里在线安装。
选型的时候注意，Device里选的型号必须和实际芯片一致。比如你用的是STM32F103C8T6，就选STM32F103C8，别选成STM32F103CB，虽然都是64KB Flash，但RAM大小不一样，链接脚本会出错。如果芯片包版本太老，可能找不到某些新型号，去Keil官网下最新的DFP包。
注意：Keil5兼容C51和STM32的问题，本质是两个独立的安装目录。C51和MDK可以装在同一台电脑上，但不要装在同一目录下，否则注册机会冲突。建议C51装C:\Keil_v5_C51，MDK装C:\Keil_v5_MDK。
3.2 Debug选项卡里必须检查的五个参数
打开Options for Target，切到Debug页，选择“ST-Link Debugger”，点Settings，这里有几个关键参数：
第一，Port选SWD，别选JTAG。第二，Max Clock不要拉到最高，先设1MHz，稳定后再往上调。第三，Reset方式选“Connect under Reset”或者“Hardware Reset”，前者适合芯片里已经有程序在跑的情况，后者适合空片。第四，Flash Download页里确认“Programming Algorithm”加载了对应芯片的Flash算法，比如STM32F10x High-density Flash。第五，勾选“Reset and Run”，这样烧录完自动运行，不用手动按复位。
| 参数 | 推荐值 | 说明 |
|---|---|---|
| Port | SWD | 引脚少，抗干扰强 |
| Max Clock | 1MHz起步 | 稳定后可提到4MHz |
| Reset | Connect under Reset | 芯片有程序时用 |
| Programming Algorithm | 对应型号 | 缺了会报No Algorithm |
| Reset and Run | 勾选 | 烧录后自动运行 |
如果Flash Download页里没有对应的算法，点“Add”从Keil安装目录的ARM\Flash里找，或者从芯片包目录里复制。
3.3 XTAL变灰和下载失败的关系
有人发现Target选项卡里的XTAL字段是灰色的，改不了。这其实不是bug，是因为你在Device里选的芯片型号，Keil5根据芯片描述文件自动锁定了外部晶振频率。XTAL只影响仿真时的时序计算，不影响实际烧录。如果你非要用外部晶振做仿真，可以在Debug页的Initialization File里手动指定。
真正导致下载失败的是另一个隐藏问题：Flash算法地址冲突。如果你之前烧过其他厂家的芯片，Keil5可能残留了旧的Flash算法，地址范围和新芯片重叠。解决办法是在Flash Download页里删掉所有算法，重新Add当前芯片的。
4. 烧录失败排查：从报错信息反推根因
烧录失败不可怕，可怕的是不知道从哪查。这一章按报错信息分类，给出排查链路。
4.1 “No ST-Link detected”的三层排查法
第一层，物理连接。量一下ST-Link的3.3V和GND之间是不是3.3V，SWCLK和SWDIO有没有接反。SWDIO是PA13，SWCLK是PA14，别搞混。第二层，驱动状态。设备管理器里看ST-Link有没有正常识别，有没有黄色感叹号。第三层，Keil5配置。Debug页里选的调试器是不是ST-Link，Port是不是SWD。
如果三层都没问题，试试降低Max Clock到500kHz，有些克隆版ST-Link在高速下握手失败。还不行就换一个USB口，或者换一台电脑，排除电脑USB控制器兼容性问题。
4.2 “SWD/JTAG Communication Failure”的六种可能
这个报错比“No ST-Link”更具体，说明ST-Link识别到了，但和芯片通信失败。可能原因：
- 芯片没供电。ST-Link的3.3V输出电流有限，如果板子上有耗电大的外设，芯片可能没正常上电。用万用表量芯片VDD引脚。
- 复位引脚被拉低。有些板子的复位电路设计有问题，NRST一直低电平，芯片处于复位状态，SWD连不上。
- SWD引脚被复用。代码里把PA13、PA14配置成了普通GPIO，或者开启了读保护。
- 芯片进入低功耗模式。Stop或Standby模式下SWD会断开，需要唤醒。
- Flash读保护。芯片被锁了，需要先解除保护。
- 信号完整性差。杜邦线超过20cm，或者SWCLK/SWDIO走线旁边有高频干扰源。
排查顺序：先量供电，再量复位，然后试“Connect under Reset”，最后检查代码里有没有动SWD引脚。
4.3 芯片被锁后的解锁流程
如果芯片开了读保护，SWD会拒绝连接。解锁方法：用STM32CubeProgrammer，选ST-Link，Mode选“Under reset”，然后点“Full chip erase”。擦除后读保护自动解除。如果CubeProgrammer也连不上，用BOOT0拉高进入系统存储器启动模式，通过串口或者USB DFU擦除。
提示：解除读保护会擦除整个Flash，代码会丢，操作前确认没有重要数据。
5. 批量烧录与离线下载的工程化思路
产品小批量试产的时候，一台一台用Keil5点Download太慢。这时候需要离线烧录或者脚本化烧录。
5.1 ST-Link Utility和STM32CubeProgrammer的命令行用法
ST-Link Utility是老工具，界面简单，支持命令行。STM32CubeProgrammer是新工具，功能更全，也支持命令行。批量烧录可以用命令行脚本：
STM32_Programmer_CLI.exe -c port=SWD -w firmware.hex -v -rst这条命令的意思是：用SWD口连接，烧录firmware.hex，校验，然后复位运行。把这条命令写成bat脚本，循环调用，配合治具就能实现半自动烧录。
5.2 离线烧录器和产线治具的配合
量产阶段用离线烧录器更合适，比如把固件存到SD卡里，烧录器自动检测芯片插入后烧录。ST-Link本身不支持离线，但市面上有基于ST-Link方案的离线烧录机。产线治具一般用Pogo Pin顶针接触SWD、GND、3.3V、NRST这几个点，操作员放板、按启动、等绿灯亮，几秒钟一片。
治具设计要注意：SWCLK和SWDIO的走线尽量等长，NRST要引出来，因为批量烧录时“Connect under Reset”最稳。电源用外部3.3V供电，别依赖ST-Link的3.3V输出，电流不够。
6. 那些文档里不会写的实操心得
最后分享几个我踩过的坑和总结的技巧。
第一，杜邦线的长度是隐形杀手。我遇到过烧录F407时好时坏，换了三根线才发现是某根杜邦线内部断了一半，时通时断。后来自己做了一根20cm以内的排线，问题消失。SWD信号在1MHz以上时，线长超过30cm就容易出错。
第二，Keil5的“Connect under Reset”不是万能的。有些板子的NRST引脚没有引出，或者复位电路是RC复位，ST-Link拉低NRST的时间不够，芯片还没进入复位状态就松开了。这时候可以在Debug页的Initialization File里加一段延时，或者改用“Hardware Reset”。
第三，芯片包版本和Keil5版本要匹配。老版本的Keil5 MDK（比如5.14）装最新的STM32F4 DFP包可能会报错，因为DFP包依赖新的CMSIS。要么升级Keil5，要么找旧版DFP包。
第四，烧录速度不是越快越好。Max Clock设到4MHz以上时，如果板子走线不好，误码率会上升，表现为烧录成功但运行异常。我一般设1MHz，稳定压倒一切。
第五，养成烧录前先擦除的习惯。尤其是调试阶段，Flash里残留的旧程序可能影响新程序的运行。在Flash Download页勾选“Erase Full Chip”或者“Erase Sectors”，别用“Do not Erase”。
这套Keil5加ST-Link的流程，说到底就是“接线对、驱动对、配置对”三件事。但每一件事下面都有一堆细节，任何一个细节出问题都会让你卡住。我自己的习惯是，新板子第一次烧录一定用“Connect under Reset”加1MHz时钟，成功后再逐步提速。遇到问题先量电压、再量复位、最后查代码，按这个顺序走，九成问题都能定位。