“遇事不决STM32”这句话在嵌入式圈子里流传了很久也确实是很多工程师的真实状态。不管你是做毕设的学生、刚转行的新手还是偶尔需要碰一碰硬件的软件工程师只要打开过STM32的工程大概率都经历过这样一个过程代码写好了编译过了但一点下载按钮弹出一堆看不懂的报错或者芯片完全没反应程序根本没跑起来。这中间的链条就是从源码到烧录的完整过程。很多人习惯用IDE一把梭点一下编译下载就完事但一旦出了错就完全不知道问题出在哪一环。这篇内容就是把这条链路拆开揉碎从源码组织、编译链接到生成烧录文件再到用ST-Link、J-Link这些工具把程序写进芯片把每一步的原理和实操都讲清楚顺便把我这些年踩过的坑也一并倒出来。适合所有正在做STM32开发、想搞明白“程序到底是怎么跑进芯片的”朋友参考。1. 内容整体设计与思路拆解这条链路到底是怎么回事先说一个容易被忽略的事实STM32的开发本质上是“交叉编译”。你的代码是在PC上写的但最终运行在ARM Cortex-M内核的芯片上所以编译工具链、链接脚本、烧录方式和PC上的软件开发有非常大的区别。1.1 从源码到烧录完整链路包含哪几个环节一条完整的链路大概是这样的编写源码包括C文件、头文件以及启动文件startup、链接脚本.ld或.sct。这些是程序的“原材料”。编译把C源码编译成汇编再汇编成机器码最后链接成可执行文件。这一步产出的是包含调试信息和地址映射的ELF文件在Keil里是.axf。格式转换把ELF文件转换成可以直接烧录到Flash的hex或bin文件。hex带地址信息bin是裸数据两者用途不同。烧录通过调试器ST-Link、J-Link、DAP-Link和烧录软件STM32CubeProgrammer、J-Flash、Keil内置下载把hex或bin写入芯片内部Flash的指定地址。复位运行芯片上电后从Flash中取出指令执行程序就跑起来了。这条链路里最容易出问题的不是第2步的编译编译器会明确告诉你哪里错了而是第4步烧录。因为烧录涉及硬件连接、驱动、目标芯片状态、读写保护等多重因素报错信息往往又很抽象。1.2 为什么一定要搞懂烧录原理而不是直接点下载按钮很多初学者用的都是“傻瓜式”开发板板载ST-Link插上USB线Keil里点一下Download程序就跑起来了非常顺利。但一旦脱离开发板自己画板子、自己接调试器问题立刻涌现怎么连SWD接口为什么识别不到芯片为什么烧录到一半提示校验失败为什么程序烧进去以后一上电就死这些问题的根源都是对烧录原理不够熟悉。烧录本质上是调试器通过SWD或JTAG协议和芯片内部的调试接口通信然后通过调试接口访问Flash控制器把数据写入Flash。这里面涉及时序、电平、时钟频率、目标芯片的电源状态、复位状态甚至芯片的读保护等级。任何一个环节不对烧录就失败。所以我的建议是不要满足于在IDE里点一下Download而是要搞清楚你在点这个按钮的时候背后发生了什么。这也是我把“从源码到烧录”拆成几个独立章节来讲的原因。2. 源码准备与开发环境别小看工程结构坑都在细节里2.1 Keil MDK和VSCodeCMake两条主流路线的选择写STM32的源码目前主流是两条路线一是Keil MDK二是VSCode配合CMake和arm-none-eabi-gcc工具链。我的个人经验是初学者老老实实用Keil原因很简单它把所有环节整合在一起你只需要关注业务代码环境配置基本不用操心。但如果你想要跨平台开发、用Git做版本管理更舒服、或者想彻底搞懂编译过程那VSCodeGCC这条路值得花时间折腾。这里补充一个基础概念Keil MDK用的是ARMCC编译器现在新版本叫Arm Compiler 6基于Clang生成的文件后缀是.axf、.hex和.binVSCodeGCC那条路用的是arm-none-eabi-gcc生成的是.elf、.hex和.bin。内核一样但输出的可执行文件格式细节略有区别.axf和.elf本质上是同类文件都是带调试信息和符号表的可执行文件烧录时用的是从中提取出的hex或bin。展开来讲如果你被代码框架问题卡住有一个很实用的办法用STM32CubeMX生成一个最基础的工程什么事都不做先把编译、烧录跑通后面加逻辑就会简单很多因为你可以确定问题出在哪儿是代码问题还是环境问题不用一锅粥地排查。2.2 源码目录结构里藏着哪些关键文件一个标准的STM32工程目录结构大致是这样的核心库CMSIS包括内核设备头文件和系统初始化代码这是芯片厂商和ARM共同提供的定义了寄存器地址映射和中断向量表的位置。外设驱动库HAL或标准外设库TI意法半导体提供的操作片上外设GPIO、USART、TIM、SPI、I2C等的函数库。现在默认用HAL库标准外设库基本已经停止更新但很多老项目还在用。启动文件startup_stm32fxxx.s一段汇编代码主要做两件事一是分配栈和堆二是建立中断向量表。芯片复位后CPU从Flash的0x08000000地址读取栈指针然后从0x08000004读取复位中断处理函数的地址跳过去执行这个流程就是启动文件定义的。链接脚本STM32Fxxx_FLASH.ldKeil里对应的是分散加载文件.sct它的作用是告诉链接器Flash和RAM的地址范围是多少代码段放在哪里数据段放在哪里。这个文件一旦配置错误烧录进去的程序基本必死。很多人初次接触这些文件会头大但我的建议是至少要把启动文件和链接脚本大概看一遍。因为当你遇到程序莫名其妙跑飞的问题时很大概率要么是栈空间不足启动文件里定义的Stack_Size太小要么是链接脚本的Flash起始地址和你实际烧录地址不匹配。2.3 源码编译的第一步预处理、编译、汇编、链接严格来说我们的C源代码在变成烧录文件之前要经历四个阶段预处理处理#include、#define、#ifdef这些指令把宏展开把头文件内容插入到源文件中。编译把预处理后的C代码转换成汇编代码。这一步会做语法检查如果报错基本都发生在这里。汇编把汇编代码转换成机器指令生成目标文件.o。目标文件里包含的机器码此时还没有分配最终的绝对地址采用的是一种可重定位的地址表示。链接把多个目标文件和库文件合并按照链接脚本的规则为代码和数据分配最终的地址生成可执行文件。前两步的问题编译器会直接报错基本没什么悬念。真正玄学的是链接这一步比如符号未定义、重复定义、内存溢出这些报错都发生在链接阶段。有一个常见的问题是Undefined symbol代码语法没错但报找不到某个函数这时候要检查是不是漏加了对应的源文件或者库文件的链接顺序不对。Keil的工程管理中右键点击Source Group选择Add Existing Files把缺失的.c文件加进去就行。3. 编译与生成烧录文件搞懂ELF、Hex和Bin的区别3.1 编译器生成的“中间产物”都有什么用编译完成后工程目录下会多出一堆文件。以Keil为例默认会生成.axf文件就是ELF格式包含调试信息、符号表、程序地址等。调试时用的就是这个文件。.hex文件Intel HEX格式以ASCII文本存储每行都包含起始地址、数据长度和数据内容。烧录器就是根据这些地址信息把数据写入芯片对应位置。.bin文件纯二进制文件没有地址信息只有裸数据。烧录时由烧录软件或用户指定写入的起始地址。三者的关系可以类比成.axf是源文档带格式、带批注.hex是带有页码索引的打印稿.bin是纯文字内容本身。大多数烧录工具既支持hex也支持bin但如果用bin一定要在烧录软件里设置正确的起始地址比如STM32F103的Flash起始地址是0x08000000如果地址设置错了程序就是乱的。3.2 地址映射和链接脚本程序为什么必须放在0x08000000有朋友问过为什么STM32的代码一定要从0x08000000开始放这个地址看起来就很奇怪。这其实是芯片设计决定的。STM32内部Flash的地址范围在F1系列上是从0x08000000到0x0807FFFF容量不同上限不同CPU上电后会把0x08000000这个地址映射到地址0x00000000所以从0x08000000取指实际上就是从Flash的起始位置取指。链接脚本的Flash起始地址如果写错编译出来的程序地址就不在Boot区的映射范围内CPU复位后会读到全0或固定的无效值程序自然跑不起来。这个错误在自作PCB时经常出现比如把Flash地址起点误写成了0x08010000程序烧到了偏移64KB的位置除非特意配置了Boot方式不然就是一上电就死。有一个排查思路值得分享如果你编译下载都提示成功但程序就是不运行先别急着怀疑逻辑代码。打开Keil的Options for Target在Target标签页查看IROM1的起始地址是不是0x08000000Size是不是和芯片型号匹配。再有就是打开烧录配置查看烧录起始地址是否也是0x08000000。3.3 工程配置里几个决定烧录文件能用的关键选项Keil工程其实挺多坑人细节尤其是以下几项Pack包版本不同系列芯片需要对应的Device Family Pack。版本不匹配会导致编译报错或者烧录时提示Flash算法不匹配。Flash Download配置在Utilities标签页点击Settings在Flash Download分组里必须勾选Reset and Run否则烧录完成后芯片停在调试模式需要手动复位才能运行。Programming Algorithm烧录算法文件要和芯片型号匹配。比如STM32F103ZE是512KB Flash算法文件选STM32F10x High-density Flash如果选成Medium-density烧录时会提示算法不匹配或不支持。编译优化等级调试时建议用-O0Debug级别生成的代码和源码顺序对应比较好发布时可以用高优化等级但要注意高优化下延时函数可能被优化掉寄存器操作被重排这种坑。把这些细节处理好编译出来的hex和bin才是可用的。不然就算编译成功烧录进去也是白搭。4. 烧录实操ST-Link、J-Link与STM32CubeProgrammer详细说明4.1 SWD接口和调试器选型到底用哪个目前烧录STM32用得最多的调试器是ST-Link、J-Link和DAP-Link。很多开发板板载ST-Link直接用USB线连接电脑就可以。如果自己做板子或者用的是最小系统板比如常见的STM32F103C8T6蓝色板需要外接一个独立的调试器。SWD只需要四根线SWDIO、SWCLK、GND、3.3VVCC。如果是V8板子带有T_VCC脚这四根线接好就行。J-Link和ST-Link都支持SWD接口区别在于J-Link的调试和下载速度通常更快对目标芯片电压的适应范围也更宽J-Link支持1.2V到3.3V甚至更高ST-Link一般固定3.3V或5V。如果只是日常烧录调试ST-Link完全够用便宜、稳定、官方工具链支持也好。有个坑需要提醒SWDIO和SWCLK这两个引脚在有些板子上可能已经被复用或占用比如接了外设或者LED。如果外设负载过大可能导致SWD通信不稳定下载时出现奇怪报错。我遇到过不少次把SWDIO引脚上接的电容去掉下载就正常了。所以自己设计电路时尽量别在SWDIO和SWCLK上挂大电容或高阻抗器件。4.2 使用STM32CubeProgrammer烧录的完整步骤STM32CubeProgrammer简称STM32CubeProg是ST官方出的烧录工具界面干净功能完整支持ST-Link、J-Link、UART串口烧录、USB DFU烧录等多种方式。我用下来感觉它的稳定性比老一代的STM32 ST-LINK Utility好很多尤其是新的芯片型号支持更全。这里以一个实际的F103C8T6最小系统板为例假设你已经用ST-Link的SWD接口连接好目标板操作流程如下打开STM32CubeProgrammer右上角选择ST-LINK作为调试接口点击旁边的刷新按钮确认软件识别到了ST-Link设备。点击Connect按钮软件会尝试通过SWD协议连接目标芯片。连接成功后界面下方会显示芯片的ID、型号、Flash大小等信息。如果这里显示No STM32 target found那就是没连上需要排查硬件连接。在左侧栏选择烧录文件点击Open file选择你的hex或者bin文件。如果选的是bin文件必须在Programming起始地址栏填上正确的Flash起始地址如0x08000000如果选hex文件软件会自动解析地址不需要手动填。点击Download按钮等待进度条走完直到弹出Download operation finished successfully提示。断开连接按一下目标板上的复位键程序开始运行。整个过程并不复杂但每一步都可能有不同的问题后面我会集中讲排查方法。4.3 启动模式BOOT0和BOOT1到底影响什么STM32的启动模式由BOOT0和BOOT1引脚的电平决定。这个知识点在烧录场景里也很重要因为如果你把程序烧到了Flash但BOOT引脚配置成了从SRAM或系统存储器启动程序自然是不会运行的。以F103系列为例BOOT1BOOT0启动模式X0从内部Flash启动正常模式01从系统存储器启动升级固件用11从内置SRAM启动调试用大多数开发板上BOOT0默认接低电平所以程序从Flash启动没有问题。但如果你在自制板上把BOOT0悬空或者接错芯片就可能进入系统存储器模式上电后运行的是出厂内置的Bootloader你的程序根本不会被执行。排查这个问题的办法很简单测量BOOT0引脚的电压确认是低电平。还有个冷门但实用的技巧当你的SWD引脚被程序配置成了普通GPIO导致无法连接调试器时可以把BOOT0拉高从系统存储器启动这样芯片上电后不会执行你的程序SWD引脚就不会被你的代码占用然后再用烧录工具擦除Flash恢复调试连接。4.4 读保护与烧录失败的关系STM32支持Flash读保护分三个等级Level 0无保护、Level 1禁止通过调试接口读写Flash、Level 2最高等级永久禁止调试访问且不可降级。如果你在烧录软件里看到类似Read protection is active的提示说明芯片已经被设为了Level 1保护。解决办法是在STM32CubeProgrammer里点击左侧的Option Bytes找到Read protection把它降级为Level 0AA值然后执行Apply。此时芯片通常会被自动擦除Flash里的原有代码会消失这是正常的。如果芯片设为了Level 2基本等于锁死除了用特殊手段解除否则这块芯片就浪费了。所以提醒一句量产产品如果需要加密要把Level 1作为上限Level 2慎用因为一旦启用以后想通过SWD调试就没门了。5. 常见报错与排查技巧实录别再被“No target found”吓住5.1 最常见的“no stm32 target found”问题从根上解决这句话的变体很多Keil里可能是No Target ConnectedSTM32CubeProgrammer里是Error: No STM32 target found!。大多数人一看到这个报错就想重新安装驱动但实际上这个报错的信息量非常大它告诉我们调试器没有和目标芯片建立SWD连接。而SWD连接建立不了通常有一半的原因是物理连接问题另一半是目标芯片状态问题。我的排查顺序是先确认调试器是否被电脑识别。在设备管理器里查看ST-Link对应的串行设备是否正常如果显示黄色感叹号很可能驱动没装好或者USB口供电不足。换一个USB口、换一根好点的USB线能解决很多玄学问题。确认接线正确。SWDIO接SWDIOSWCLK接SWCLKGND共地最好把目标板的3.3V也接上用调试器供电。很多调试器是可以给目标板供电的但要看清电流限制别带大负载。如果目标板有自己的电源一定要共地不共地直接导致通信不稳定。确认目标板供电正常。用万用表测一下芯片VDD引脚对地电压如果是3.3V左右正常如果没电压查板子的电源电路。尝试降低SWD速度。有些板子走线长、寄生电容大高频SWD通信容易失败。STM32CubeProgrammer里有一个频率设置降到4MHz或者更低连接成功率会大幅提升。检查目标芯片是否进入读保护或低功耗模式。读保护会直接拒绝SWD访问低功耗模式下调试接口的时钟也可能被关闭。处理办法是尝试用高电平的NRST复位信号配合连接有些烧录器支持Connect under Reset模式这个模式就是在复位释放的一瞬间发出连接请求这时候CPU还没机会执行任何代码连接成功率很高。5.2 Keil烧录失败的文字游戏从报错信息反推原因Keil烧录失败时Output窗口会打印一串信息很多人只看最后一行发现是Error就拍照发群里问。其实往上翻前几行才是最关键的线索。常见的组合如下报错关键片段实际原因处理办法Cannot access target. Shutting down debug session调试器没连上目标芯片物理连接或芯片状态问题按5.1的步骤排查Flash Download failed - Cortex-M3烧录算法不匹配或Flash配置错误检查Flash算法配置确认芯片型号和算法匹配Error: Flash Download failed - Target DLL has been cancelled下载被取消多半是连接不稳定降低SWD时钟换短线检查供电Internal command error调试器固件版本和Keil不兼容升级ST-Link固件或者升级Keil版本No Algorithm found for address烧录地址超出了所选算法支持的Flash范围检查算法选择和Flash地址设置还有一个经常忽略的问题是Keil打开工程后第一次烧录如果提示缺PACK包后面烧录也会出现各种奇怪错误。建议拿到工程后先到Pack Installer里确认对应器件包已安装并且版本正确。5.3 程序烧进去了但跑不起来先从这4个方向查如果说烧录失败还能通过排查解决程序烧进去但不运行就属于最让人头疼的问题之一。我的经验是先做减法把问题缩小到以下四个方面复位电路。STM32的NRST引脚上需要接一个100nF左右的电容到地如果没接或者电容过大复位信号波形异常芯片可能一直处于复位状态程序无法运行。Boot引脚状态。前面说过的BOOT0和BOOT1必须确认是低电平也就是从Flash启动。时钟配置。HAL库默认使用HSI内部8MHz时钟如果工程配置的是HSE外部晶振而板子上没有外部晶振或者晶振没起振程序会卡在时钟配置的等待循环中永远跑不出来。查这个问题的办法在SystemClock_Config函数里加一个串口打印或者在调试器里全速运行后停住看PC指针停在哪个函数。向量表位置。如果是自己做的bootloader应用或者把程序放到非0x08000000起始的地址需要设置VTOR寄存器把中断向量表重定位到对应位置。很多新手把APP放在0x08010000但忘了改VTOR导致中断全部失效程序虽然跑了但表现就是不响应中断和外设交互完全失灵。这几个方向排查完大部分“烧录成功但跑不起来”的问题都能定位。尤其是时钟配置是我见过最高频的坑十个里有五个是卡死在外设初始化上。5.4 一个实打实的现场案例板上SWD怎么都连不上去年我给一个朋友调过一块板子现象非常典型STM32F103VET6主控三天前烧录一切正常今天突然连不上调试器。SWDIO和SWCLK电压看似正常但STM32CubeProgrammer始终报No target found。换了USB线、换了ST-Link都不行。最后用示波器抓SWCLK脚发现波形只有0.8V左右低到夸张。顺着线路查发现SWDIO上并联了一个10nF的电容这个电容是朋友为了滤除EMI加上去的但10nF对几MHz的SWD时钟来说容抗太小直接把高频信号旁路掉了。把电容拆掉下载一次性成功。这个案例想说明的是SWD接口能免则免不要额外加滤波电容如果非要加选几十pF以内千万别用nF级别。这种问题一旦遇到排查起来非常隐蔽因为你测量引脚电平会发现是正常的但高速通信就是起不来。6. 一些长期实践下来攒下的习惯做嵌入式这几年我养成了几个看起来不起眼但非常实用的习惯这里分享一下。第一每条新板子到手第一时间用STM32CubeProgrammer连接一次读出芯片型号和UID确认调试链路通畅。之后再做任何开发都基于这个“确认过”的基础出了问题容易定位。第二烧录文件归档时同时保留hex和bin。hex带地址方便复盘bin体积小适合量产工具使用。量产烧录我通常用J-Flash命令行模式用脚本统一设置地址、烧录算法和校验选项比手工操作稳定得多。第三不要轻易把烧录接口从板子上省掉。很多产品为了省空间不做SWD接口一旦出厂后需要升级固件只能通过串口Bootloader。虽然后续可以通过串口升级但如果Bootloader本身有bug或者中途断电板子就可能变砖。保留SWD接口其实是在保留一条“后悔药”的路径。烧录这个操作看着简单背后牵扯的硬件、协议、状态管理其实不少。把这条链路搞明白不敢说百分之百不踩坑但至少踩坑之后你能知道坑在哪一层而不是对着报错干瞪眼。希望这些内容能帮你在下一次遇到No target found的时候少走几步弯路。
STM32从源码到烧录全解析：编译链接、SWD调试与排错指南
“遇事不决STM32”这句话在嵌入式圈子里流传了很久也确实是很多工程师的真实状态。不管你是做毕设的学生、刚转行的新手还是偶尔需要碰一碰硬件的软件工程师只要打开过STM32的工程大概率都经历过这样一个过程代码写好了编译过了但一点下载按钮弹出一堆看不懂的报错或者芯片完全没反应程序根本没跑起来。这中间的链条就是从源码到烧录的完整过程。很多人习惯用IDE一把梭点一下编译下载就完事但一旦出了错就完全不知道问题出在哪一环。这篇内容就是把这条链路拆开揉碎从源码组织、编译链接到生成烧录文件再到用ST-Link、J-Link这些工具把程序写进芯片把每一步的原理和实操都讲清楚顺便把我这些年踩过的坑也一并倒出来。适合所有正在做STM32开发、想搞明白“程序到底是怎么跑进芯片的”朋友参考。1. 内容整体设计与思路拆解这条链路到底是怎么回事先说一个容易被忽略的事实STM32的开发本质上是“交叉编译”。你的代码是在PC上写的但最终运行在ARM Cortex-M内核的芯片上所以编译工具链、链接脚本、烧录方式和PC上的软件开发有非常大的区别。1.1 从源码到烧录完整链路包含哪几个环节一条完整的链路大概是这样的编写源码包括C文件、头文件以及启动文件startup、链接脚本.ld或.sct。这些是程序的“原材料”。编译把C源码编译成汇编再汇编成机器码最后链接成可执行文件。这一步产出的是包含调试信息和地址映射的ELF文件在Keil里是.axf。格式转换把ELF文件转换成可以直接烧录到Flash的hex或bin文件。hex带地址信息bin是裸数据两者用途不同。烧录通过调试器ST-Link、J-Link、DAP-Link和烧录软件STM32CubeProgrammer、J-Flash、Keil内置下载把hex或bin写入芯片内部Flash的指定地址。复位运行芯片上电后从Flash中取出指令执行程序就跑起来了。这条链路里最容易出问题的不是第2步的编译编译器会明确告诉你哪里错了而是第4步烧录。因为烧录涉及硬件连接、驱动、目标芯片状态、读写保护等多重因素报错信息往往又很抽象。1.2 为什么一定要搞懂烧录原理而不是直接点下载按钮很多初学者用的都是“傻瓜式”开发板板载ST-Link插上USB线Keil里点一下Download程序就跑起来了非常顺利。但一旦脱离开发板自己画板子、自己接调试器问题立刻涌现怎么连SWD接口为什么识别不到芯片为什么烧录到一半提示校验失败为什么程序烧进去以后一上电就死这些问题的根源都是对烧录原理不够熟悉。烧录本质上是调试器通过SWD或JTAG协议和芯片内部的调试接口通信然后通过调试接口访问Flash控制器把数据写入Flash。这里面涉及时序、电平、时钟频率、目标芯片的电源状态、复位状态甚至芯片的读保护等级。任何一个环节不对烧录就失败。所以我的建议是不要满足于在IDE里点一下Download而是要搞清楚你在点这个按钮的时候背后发生了什么。这也是我把“从源码到烧录”拆成几个独立章节来讲的原因。2. 源码准备与开发环境别小看工程结构坑都在细节里2.1 Keil MDK和VSCodeCMake两条主流路线的选择写STM32的源码目前主流是两条路线一是Keil MDK二是VSCode配合CMake和arm-none-eabi-gcc工具链。我的个人经验是初学者老老实实用Keil原因很简单它把所有环节整合在一起你只需要关注业务代码环境配置基本不用操心。但如果你想要跨平台开发、用Git做版本管理更舒服、或者想彻底搞懂编译过程那VSCodeGCC这条路值得花时间折腾。这里补充一个基础概念Keil MDK用的是ARMCC编译器现在新版本叫Arm Compiler 6基于Clang生成的文件后缀是.axf、.hex和.binVSCodeGCC那条路用的是arm-none-eabi-gcc生成的是.elf、.hex和.bin。内核一样但输出的可执行文件格式细节略有区别.axf和.elf本质上是同类文件都是带调试信息和符号表的可执行文件烧录时用的是从中提取出的hex或bin。展开来讲如果你被代码框架问题卡住有一个很实用的办法用STM32CubeMX生成一个最基础的工程什么事都不做先把编译、烧录跑通后面加逻辑就会简单很多因为你可以确定问题出在哪儿是代码问题还是环境问题不用一锅粥地排查。2.2 源码目录结构里藏着哪些关键文件一个标准的STM32工程目录结构大致是这样的核心库CMSIS包括内核设备头文件和系统初始化代码这是芯片厂商和ARM共同提供的定义了寄存器地址映射和中断向量表的位置。外设驱动库HAL或标准外设库TI意法半导体提供的操作片上外设GPIO、USART、TIM、SPI、I2C等的函数库。现在默认用HAL库标准外设库基本已经停止更新但很多老项目还在用。启动文件startup_stm32fxxx.s一段汇编代码主要做两件事一是分配栈和堆二是建立中断向量表。芯片复位后CPU从Flash的0x08000000地址读取栈指针然后从0x08000004读取复位中断处理函数的地址跳过去执行这个流程就是启动文件定义的。链接脚本STM32Fxxx_FLASH.ldKeil里对应的是分散加载文件.sct它的作用是告诉链接器Flash和RAM的地址范围是多少代码段放在哪里数据段放在哪里。这个文件一旦配置错误烧录进去的程序基本必死。很多人初次接触这些文件会头大但我的建议是至少要把启动文件和链接脚本大概看一遍。因为当你遇到程序莫名其妙跑飞的问题时很大概率要么是栈空间不足启动文件里定义的Stack_Size太小要么是链接脚本的Flash起始地址和你实际烧录地址不匹配。2.3 源码编译的第一步预处理、编译、汇编、链接严格来说我们的C源代码在变成烧录文件之前要经历四个阶段预处理处理#include、#define、#ifdef这些指令把宏展开把头文件内容插入到源文件中。编译把预处理后的C代码转换成汇编代码。这一步会做语法检查如果报错基本都发生在这里。汇编把汇编代码转换成机器指令生成目标文件.o。目标文件里包含的机器码此时还没有分配最终的绝对地址采用的是一种可重定位的地址表示。链接把多个目标文件和库文件合并按照链接脚本的规则为代码和数据分配最终的地址生成可执行文件。前两步的问题编译器会直接报错基本没什么悬念。真正玄学的是链接这一步比如符号未定义、重复定义、内存溢出这些报错都发生在链接阶段。有一个常见的问题是Undefined symbol代码语法没错但报找不到某个函数这时候要检查是不是漏加了对应的源文件或者库文件的链接顺序不对。Keil的工程管理中右键点击Source Group选择Add Existing Files把缺失的.c文件加进去就行。3. 编译与生成烧录文件搞懂ELF、Hex和Bin的区别3.1 编译器生成的“中间产物”都有什么用编译完成后工程目录下会多出一堆文件。以Keil为例默认会生成.axf文件就是ELF格式包含调试信息、符号表、程序地址等。调试时用的就是这个文件。.hex文件Intel HEX格式以ASCII文本存储每行都包含起始地址、数据长度和数据内容。烧录器就是根据这些地址信息把数据写入芯片对应位置。.bin文件纯二进制文件没有地址信息只有裸数据。烧录时由烧录软件或用户指定写入的起始地址。三者的关系可以类比成.axf是源文档带格式、带批注.hex是带有页码索引的打印稿.bin是纯文字内容本身。大多数烧录工具既支持hex也支持bin但如果用bin一定要在烧录软件里设置正确的起始地址比如STM32F103的Flash起始地址是0x08000000如果地址设置错了程序就是乱的。3.2 地址映射和链接脚本程序为什么必须放在0x08000000有朋友问过为什么STM32的代码一定要从0x08000000开始放这个地址看起来就很奇怪。这其实是芯片设计决定的。STM32内部Flash的地址范围在F1系列上是从0x08000000到0x0807FFFF容量不同上限不同CPU上电后会把0x08000000这个地址映射到地址0x00000000所以从0x08000000取指实际上就是从Flash的起始位置取指。链接脚本的Flash起始地址如果写错编译出来的程序地址就不在Boot区的映射范围内CPU复位后会读到全0或固定的无效值程序自然跑不起来。这个错误在自作PCB时经常出现比如把Flash地址起点误写成了0x08010000程序烧到了偏移64KB的位置除非特意配置了Boot方式不然就是一上电就死。有一个排查思路值得分享如果你编译下载都提示成功但程序就是不运行先别急着怀疑逻辑代码。打开Keil的Options for Target在Target标签页查看IROM1的起始地址是不是0x08000000Size是不是和芯片型号匹配。再有就是打开烧录配置查看烧录起始地址是否也是0x08000000。3.3 工程配置里几个决定烧录文件能用的关键选项Keil工程其实挺多坑人细节尤其是以下几项Pack包版本不同系列芯片需要对应的Device Family Pack。版本不匹配会导致编译报错或者烧录时提示Flash算法不匹配。Flash Download配置在Utilities标签页点击Settings在Flash Download分组里必须勾选Reset and Run否则烧录完成后芯片停在调试模式需要手动复位才能运行。Programming Algorithm烧录算法文件要和芯片型号匹配。比如STM32F103ZE是512KB Flash算法文件选STM32F10x High-density Flash如果选成Medium-density烧录时会提示算法不匹配或不支持。编译优化等级调试时建议用-O0Debug级别生成的代码和源码顺序对应比较好发布时可以用高优化等级但要注意高优化下延时函数可能被优化掉寄存器操作被重排这种坑。把这些细节处理好编译出来的hex和bin才是可用的。不然就算编译成功烧录进去也是白搭。4. 烧录实操ST-Link、J-Link与STM32CubeProgrammer详细说明4.1 SWD接口和调试器选型到底用哪个目前烧录STM32用得最多的调试器是ST-Link、J-Link和DAP-Link。很多开发板板载ST-Link直接用USB线连接电脑就可以。如果自己做板子或者用的是最小系统板比如常见的STM32F103C8T6蓝色板需要外接一个独立的调试器。SWD只需要四根线SWDIO、SWCLK、GND、3.3VVCC。如果是V8板子带有T_VCC脚这四根线接好就行。J-Link和ST-Link都支持SWD接口区别在于J-Link的调试和下载速度通常更快对目标芯片电压的适应范围也更宽J-Link支持1.2V到3.3V甚至更高ST-Link一般固定3.3V或5V。如果只是日常烧录调试ST-Link完全够用便宜、稳定、官方工具链支持也好。有个坑需要提醒SWDIO和SWCLK这两个引脚在有些板子上可能已经被复用或占用比如接了外设或者LED。如果外设负载过大可能导致SWD通信不稳定下载时出现奇怪报错。我遇到过不少次把SWDIO引脚上接的电容去掉下载就正常了。所以自己设计电路时尽量别在SWDIO和SWCLK上挂大电容或高阻抗器件。4.2 使用STM32CubeProgrammer烧录的完整步骤STM32CubeProgrammer简称STM32CubeProg是ST官方出的烧录工具界面干净功能完整支持ST-Link、J-Link、UART串口烧录、USB DFU烧录等多种方式。我用下来感觉它的稳定性比老一代的STM32 ST-LINK Utility好很多尤其是新的芯片型号支持更全。这里以一个实际的F103C8T6最小系统板为例假设你已经用ST-Link的SWD接口连接好目标板操作流程如下打开STM32CubeProgrammer右上角选择ST-LINK作为调试接口点击旁边的刷新按钮确认软件识别到了ST-Link设备。点击Connect按钮软件会尝试通过SWD协议连接目标芯片。连接成功后界面下方会显示芯片的ID、型号、Flash大小等信息。如果这里显示No STM32 target found那就是没连上需要排查硬件连接。在左侧栏选择烧录文件点击Open file选择你的hex或者bin文件。如果选的是bin文件必须在Programming起始地址栏填上正确的Flash起始地址如0x08000000如果选hex文件软件会自动解析地址不需要手动填。点击Download按钮等待进度条走完直到弹出Download operation finished successfully提示。断开连接按一下目标板上的复位键程序开始运行。整个过程并不复杂但每一步都可能有不同的问题后面我会集中讲排查方法。4.3 启动模式BOOT0和BOOT1到底影响什么STM32的启动模式由BOOT0和BOOT1引脚的电平决定。这个知识点在烧录场景里也很重要因为如果你把程序烧到了Flash但BOOT引脚配置成了从SRAM或系统存储器启动程序自然是不会运行的。以F103系列为例BOOT1BOOT0启动模式X0从内部Flash启动正常模式01从系统存储器启动升级固件用11从内置SRAM启动调试用大多数开发板上BOOT0默认接低电平所以程序从Flash启动没有问题。但如果你在自制板上把BOOT0悬空或者接错芯片就可能进入系统存储器模式上电后运行的是出厂内置的Bootloader你的程序根本不会被执行。排查这个问题的办法很简单测量BOOT0引脚的电压确认是低电平。还有个冷门但实用的技巧当你的SWD引脚被程序配置成了普通GPIO导致无法连接调试器时可以把BOOT0拉高从系统存储器启动这样芯片上电后不会执行你的程序SWD引脚就不会被你的代码占用然后再用烧录工具擦除Flash恢复调试连接。4.4 读保护与烧录失败的关系STM32支持Flash读保护分三个等级Level 0无保护、Level 1禁止通过调试接口读写Flash、Level 2最高等级永久禁止调试访问且不可降级。如果你在烧录软件里看到类似Read protection is active的提示说明芯片已经被设为了Level 1保护。解决办法是在STM32CubeProgrammer里点击左侧的Option Bytes找到Read protection把它降级为Level 0AA值然后执行Apply。此时芯片通常会被自动擦除Flash里的原有代码会消失这是正常的。如果芯片设为了Level 2基本等于锁死除了用特殊手段解除否则这块芯片就浪费了。所以提醒一句量产产品如果需要加密要把Level 1作为上限Level 2慎用因为一旦启用以后想通过SWD调试就没门了。5. 常见报错与排查技巧实录别再被“No target found”吓住5.1 最常见的“no stm32 target found”问题从根上解决这句话的变体很多Keil里可能是No Target ConnectedSTM32CubeProgrammer里是Error: No STM32 target found!。大多数人一看到这个报错就想重新安装驱动但实际上这个报错的信息量非常大它告诉我们调试器没有和目标芯片建立SWD连接。而SWD连接建立不了通常有一半的原因是物理连接问题另一半是目标芯片状态问题。我的排查顺序是先确认调试器是否被电脑识别。在设备管理器里查看ST-Link对应的串行设备是否正常如果显示黄色感叹号很可能驱动没装好或者USB口供电不足。换一个USB口、换一根好点的USB线能解决很多玄学问题。确认接线正确。SWDIO接SWDIOSWCLK接SWCLKGND共地最好把目标板的3.3V也接上用调试器供电。很多调试器是可以给目标板供电的但要看清电流限制别带大负载。如果目标板有自己的电源一定要共地不共地直接导致通信不稳定。确认目标板供电正常。用万用表测一下芯片VDD引脚对地电压如果是3.3V左右正常如果没电压查板子的电源电路。尝试降低SWD速度。有些板子走线长、寄生电容大高频SWD通信容易失败。STM32CubeProgrammer里有一个频率设置降到4MHz或者更低连接成功率会大幅提升。检查目标芯片是否进入读保护或低功耗模式。读保护会直接拒绝SWD访问低功耗模式下调试接口的时钟也可能被关闭。处理办法是尝试用高电平的NRST复位信号配合连接有些烧录器支持Connect under Reset模式这个模式就是在复位释放的一瞬间发出连接请求这时候CPU还没机会执行任何代码连接成功率很高。5.2 Keil烧录失败的文字游戏从报错信息反推原因Keil烧录失败时Output窗口会打印一串信息很多人只看最后一行发现是Error就拍照发群里问。其实往上翻前几行才是最关键的线索。常见的组合如下报错关键片段实际原因处理办法Cannot access target. Shutting down debug session调试器没连上目标芯片物理连接或芯片状态问题按5.1的步骤排查Flash Download failed - Cortex-M3烧录算法不匹配或Flash配置错误检查Flash算法配置确认芯片型号和算法匹配Error: Flash Download failed - Target DLL has been cancelled下载被取消多半是连接不稳定降低SWD时钟换短线检查供电Internal command error调试器固件版本和Keil不兼容升级ST-Link固件或者升级Keil版本No Algorithm found for address烧录地址超出了所选算法支持的Flash范围检查算法选择和Flash地址设置还有一个经常忽略的问题是Keil打开工程后第一次烧录如果提示缺PACK包后面烧录也会出现各种奇怪错误。建议拿到工程后先到Pack Installer里确认对应器件包已安装并且版本正确。5.3 程序烧进去了但跑不起来先从这4个方向查如果说烧录失败还能通过排查解决程序烧进去但不运行就属于最让人头疼的问题之一。我的经验是先做减法把问题缩小到以下四个方面复位电路。STM32的NRST引脚上需要接一个100nF左右的电容到地如果没接或者电容过大复位信号波形异常芯片可能一直处于复位状态程序无法运行。Boot引脚状态。前面说过的BOOT0和BOOT1必须确认是低电平也就是从Flash启动。时钟配置。HAL库默认使用HSI内部8MHz时钟如果工程配置的是HSE外部晶振而板子上没有外部晶振或者晶振没起振程序会卡在时钟配置的等待循环中永远跑不出来。查这个问题的办法在SystemClock_Config函数里加一个串口打印或者在调试器里全速运行后停住看PC指针停在哪个函数。向量表位置。如果是自己做的bootloader应用或者把程序放到非0x08000000起始的地址需要设置VTOR寄存器把中断向量表重定位到对应位置。很多新手把APP放在0x08010000但忘了改VTOR导致中断全部失效程序虽然跑了但表现就是不响应中断和外设交互完全失灵。这几个方向排查完大部分“烧录成功但跑不起来”的问题都能定位。尤其是时钟配置是我见过最高频的坑十个里有五个是卡死在外设初始化上。5.4 一个实打实的现场案例板上SWD怎么都连不上去年我给一个朋友调过一块板子现象非常典型STM32F103VET6主控三天前烧录一切正常今天突然连不上调试器。SWDIO和SWCLK电压看似正常但STM32CubeProgrammer始终报No target found。换了USB线、换了ST-Link都不行。最后用示波器抓SWCLK脚发现波形只有0.8V左右低到夸张。顺着线路查发现SWDIO上并联了一个10nF的电容这个电容是朋友为了滤除EMI加上去的但10nF对几MHz的SWD时钟来说容抗太小直接把高频信号旁路掉了。把电容拆掉下载一次性成功。这个案例想说明的是SWD接口能免则免不要额外加滤波电容如果非要加选几十pF以内千万别用nF级别。这种问题一旦遇到排查起来非常隐蔽因为你测量引脚电平会发现是正常的但高速通信就是起不来。6. 一些长期实践下来攒下的习惯做嵌入式这几年我养成了几个看起来不起眼但非常实用的习惯这里分享一下。第一每条新板子到手第一时间用STM32CubeProgrammer连接一次读出芯片型号和UID确认调试链路通畅。之后再做任何开发都基于这个“确认过”的基础出了问题容易定位。第二烧录文件归档时同时保留hex和bin。hex带地址方便复盘bin体积小适合量产工具使用。量产烧录我通常用J-Flash命令行模式用脚本统一设置地址、烧录算法和校验选项比手工操作稳定得多。第三不要轻易把烧录接口从板子上省掉。很多产品为了省空间不做SWD接口一旦出厂后需要升级固件只能通过串口Bootloader。虽然后续可以通过串口升级但如果Bootloader本身有bug或者中途断电板子就可能变砖。保留SWD接口其实是在保留一条“后悔药”的路径。烧录这个操作看着简单背后牵扯的硬件、协议、状态管理其实不少。把这条链路搞明白不敢说百分之百不踩坑但至少踩坑之后你能知道坑在哪一层而不是对着报错干瞪眼。希望这些内容能帮你在下一次遇到No target found的时候少走几步弯路。
