STM32F103开发板从零到点灯：避开新手必踩的坑

STM32F103的开发板到手那天我拆快递的手都有点抖。不是矫情是这块蓝色小板子背后代表的东西太多了——从51单片机那种“寄存器直接怼”的玩法切换到32位ARM Cortex-M3内核外设多到记不住时钟树复杂得像迷宫光是一个GPIO的配置就有七八个寄存器要填。很多人就是在这个阶段被劝退的板子买回来了Keil装好了例程也下载了但就是点不亮第一颗LED然后就开始怀疑自己是不是不适合搞嵌入式。这篇内容就是写给刚拿到STM32F103开发板、准备从零开始啃的朋友。我会把从开箱到跑通第一个工程这条链路上所有容易卡住的地方拆开讲清楚——不是那种“第一步安装Keil第二步新建工程”的流水账而是告诉你为什么这么做、不这么做会出什么问题、以及我踩过的那些坑。不管你是电子专业的学生、转行做嵌入式的工程师还是纯粹想玩硬件的爱好者只要手里有一块F103的板子这篇内容都能帮你少走至少两周的弯路。1. 拿到板子先别急着上电这几件事决定了你后面顺不顺1.1 确认芯片型号和封装别被“STM32F103”这个笼统名字骗了“STM32F103”只是一个系列名下面细分了几十种型号。你板子上焊的到底是C8T6、RCT6还是ZET6直接决定了你能用多少Flash、多少RAM、有哪些外设。C8T6是64KB Flash、20KB RAM、48个引脚RCT6是256KB Flash、48KB RAM、64个引脚ZET6是512KB Flash、64KB RAM、144个引脚。如果你拿C8T6的例程往RCT6上烧可能能跑但一旦用到额外引脚就会出问题。怎么确认看芯片表面的丝印。STM32F103后面跟的那串字符比如“C8T6”C代表48脚封装8代表64KB FlashT代表LQFP封装6代表工业级温度范围。把这个搞清楚了后面选例程、配工程、查数据手册才不会张冠李戴。提示如果你买的是那种“最小系统板”板子上通常只引出了排针没有板载外设。这种板子适合已经有一定基础的人做项目验证但纯新手建议买带LED、按键、串口芯片的“开发板”不然你连点灯都要自己飞线。1.2 检查供电跳线帽和BOOT引脚这两个地方最容易让板子“装死”很多开发板上有跳线帽用来选择供电来源——是USB供电还是外部DC供电。如果跳线帽没插对板子上电后电源指示灯亮但芯片不工作你会以为是芯片坏了其实只是供电没通到MCU。BOOT引脚更关键。STM32F103有两个BOOT引脚BOOT0和BOOT1。它们的组合决定了芯片从哪启动BOOT0BOOT1启动模式0X从主Flash启动正常运行10从系统存储器启动串口下载11从SRAM启动调试用正常跑程序时BOOT0必须接地。如果你用串口下载程序需要把BOOT0拉到高电平下载完再拨回去。我见过太多人下载完程序忘了把BOOT0拨回低电平然后纳闷为什么程序不跑——因为芯片一直在等串口下载指令。1.3 安装STM32芯片包之前先搞清楚Keil的版本问题Keil MDK从5.0版本开始芯片支持包Device Family Pack和编译器是分开安装的。你装完Keil MDK本体之后里面是空的新建工程时找不到STM32F103的型号。需要额外下载安装Keil.STM32F1xx_DFP这个包。这里有个坑Keil MDK的编译器版本ARM Compiler和芯片包之间有兼容性要求。如果你用的是Keil MDK 5.38以上版本默认编译器是AC6而很多老例程是基于AC5写的编译时会报一堆错误。解决办法是在工程设置里把编译器切回AC5或者手动安装AC5编译器。我个人的建议是新手直接用Keil MDK 5.36版本这个版本对AC5和AC6的支持都比较均衡网上大部分F103的例程都能直接编译。2. 从零建一个能跑的工程比你想的要多做几步2.1 标准库还是HAL库这个选择会影响你后面所有的学习路径STM32F103的代码开发主要有三种方式标准外设库Standard Peripheral Library、HAL库、以及直接操作寄存器。标准库是ST早期推出的代码直观、结构清晰适合理解底层原理HAL库是ST现在主推的配合STM32CubeMX可以图形化配置跨系列移植方便但封装层次深出了问题不好排查。对于F103这块芯片我的建议是先学标准库再了解HAL库。原因很简单——F103的标准库资料最丰富网上能找到的例程最多而且标准库的代码逻辑更接近硬件本身学完之后你对STM32的理解会更扎实。如果你一上来就用CubeMX生成HAL库代码可能项目跑起来了但问你“串口波特率是怎么算出来的”你答不上来。2.2 新建工程的目录结构决定了你后面找文件的速度很多人新建工程就是把所有文件往一个文件夹里一扔刚开始文件少还能忍等工程大了之后找个头文件要翻半天。我习惯的目录结构是这样的Project/ ├── CMSIS/ # 内核相关文件 ├── Library/ # 标准库外设驱动 ├── User/ # 用户代码main.c等 ├── Start/ # 启动文件 ├── HardWare/ # 硬件驱动LED、按键、串口等 └── Output/ # 编译输出文件这个结构不是必须的但好处是清晰。CMSIS和Library直接从ST的库文件里拷贝User放你自己的代码HardWare放你写的外设驱动。编译输出单独放一个文件夹方便清理。2.3 添加文件到工程时的分组逻辑别让Keil的工程树变成一团乱麻Keil的工程窗口里可以建“Group”相当于文件夹。我一般会建这几个组Start、CMSIS、Library、User、HardWare。然后把对应的.c文件加进去。注意头文件的路径要在“Options for Target → C/C → Include Paths”里添加否则编译时会报“cannot open source input file”的错误。这里有个细节标准库的“stm32f10x_conf.h”文件用来配置哪些外设驱动参与编译。如果你只用GPIO和串口就把其他外设的include注释掉这样可以加快编译速度。但新手经常犯的错误是把所有include都注释了然后调用RCC_APB2PeriphClockCmd时找不到声明——因为这个函数在stm32f10x_rcc.h里你得确保这个头文件被include了。2.4 时钟配置不对后面所有外设的时间都是错的STM32F103的外部晶振通常是8MHz经过PLL倍频到72MHz作为系统时钟。但如果你用的是内部RC振荡器HSI默认是8MHz精度差很多串口通信容易出误码。所以第一步就是确认你的板子上有没有焊8MHz晶振然后在SystemInit函数里确认时钟配置。标准库的system_stm32f10x.c文件里有一个宏定义叫“SYSCLK_FREQ_72MHz”确保它没有被注释掉。然后在main函数开头调用SystemInit()这个函数会把系统时钟配到72MHz。如果你不调用它芯片跑在默认的8MHz HSI上延时函数的时间会差9倍串口波特率也会错。注意有些开发板的例程里把SystemInit()放在启动文件里自动调用了你不需要在main里再调一次。但如果你是自己新建的工程一定要确认这个函数被调用了。验证方法很简单写一个LED闪烁程序延时用500ms如果实际闪得比预期快很多大概率就是时钟没配对。3. 烧录程序这件事卡住的人比想象中多3.1 ST-Link、J-Link、串口下载选哪个取决于你手头有什么STM32F103支持三种下载方式SWD/JTAG调试器下载ST-Link或J-Link、串口ISP下载、以及USB DFU下载需要芯片支持USB外设。新手最常用的是ST-Link和串口下载。ST-Link的优势是可以在线调试设断点、看变量、单步执行排查问题时非常有用。串口下载的优势是便宜一个USB转TTL模块只要十几块钱但缺点是不能调试只能下载。如果你买的是那种几十块钱的“STM32最小系统板”通常板载了USB转串口芯片CH340或CP2102可以直接用串口下载。但要注意串口下载需要把BOOT0拉高、BOOT1拉低下载完再拨回去。而且串口下载的波特率不能太高一般用115200比较稳。3.2 Keil里配置ST-Link下载时这几个选项必须检查在Keil的“Options for Target → Debug”里选择“ST-Link Debugger”然后点“Settings”。在弹出的窗口里确认“Port”选的是SWD而不是JTAG。SWD只需要两根线SWDIO和SWCLK比JTAG少占用引脚。然后在“Flash Download”标签页里确认“Programming Algorithm”里有STM32F10x High-density Flash如果是C8T6这种中容量芯片选Medium-density。如果这个算法没加载下载时会报“Flash Download failed”的错误。还有一个容易忽略的地方“Reset and Run”选项。勾上它之后下载完程序会自动复位运行不用手动按复位键。不勾的话下载完芯片停在复位状态你得手动按一下板子上的复位按钮。3.3 编译成功但烧录失败排查顺序应该是这样的“编译成功但烧录不进去”是新手遇到最多的问题之一。排查顺序我建议从硬件到软件第一步检查ST-Link和板子的连线。SWDIO、SWCLK、GND、3.3V这四根线必须接对。有些板子的SWD接口顺序不是标准的要看板子上的丝印。第二步检查ST-Link驱动有没有装好。在设备管理器里看有没有“STMicroelectronics STLink dongle”这个设备如果有黄色感叹号就是驱动问题。第三步检查Keil里的调试器配置。确认选的是ST-LinkPort选SWDFlash算法选对了。第四步检查芯片是不是被读保护了。如果之前烧过程序设置了读保护ST-Link会连不上。解决办法是用ST-Link Utility工具连接芯片在“Target → Option Bytes”里把读保护关掉。第五步检查供电。有些板子用ST-Link供电时电流不够芯片工作不稳定。试试用外部电源供电。3.4 串口下载失败八成是BOOT引脚或波特率的问题串口下载需要用STM32的System Memory启动模式也就是BOOT01、BOOT10。然后打开STM32CubeProgrammer或者FlyMcu这类工具选择串口配置波特率一般115200然后点下载。如果一直提示“同步失败”先检查BOOT0是不是真的拉高了。有些板子的BOOT0跳线帽设计得很隐蔽你可能以为拨过去了其实没有。然后检查串口线是不是TX接RX、RX接TX——串口通信是交叉连接的TX对RXRX对TXGND对GND。还有一个坑有些USB转TTL模块的3.3V输出电流不够导致STM32在下载过程中复位。试试用外部电源给板子供电USB转TTL只接TX、RX、GND三根线。4. 第一个程序跑通之后下一步该往哪走4.1 点灯只是开始GPIO的八种模式你得挨个试一遍点亮LED只是验证了GPIO的输出功能但STM32的GPIO有八种模式输入浮空、输入上拉、输入下拉、模拟输入、开漏输出、推挽输出、开漏复用、推挽复用。每种模式的应用场景不同。推挽输出用来驱动LED、继电器这类需要强驱动能力的负载开漏输出用来做I2C通信或者电平转换输入上拉用来接按键按键另一端接地模拟输入用来接ADC采集电压。我建议你写一个测试程序把这八种模式都配置一遍用万用表量一下引脚电压这样理解最深刻。4.2 串口是调试之母先把printf重定向搞定嵌入式开发没有屏幕串口就是你跟芯片对话的窗口。把printf函数重定向到串口你就可以在电脑上用串口助手看到程序内部的变量值、状态信息排查问题时效率翻倍。标准库下重定向printf的方法是在main.c里加这段代码int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t)ch); while(USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); return ch; }然后在Keil的“Options for Target → Target”里勾上“Use MicroLIB”。不勾的话printf会调用标准C库代码体积大很多而且可能跑不起来。4.3 定时器和中断是STM32真正好玩的地方GPIO和串口只是开胃菜定时器和中断才是STM32的精髓。F103有多个通用定时器TIM2到TIM5和一个高级定时器TIM1。通用定时器可以做定时中断、PWM输出、输入捕获高级定时器还能做互补输出用来驱动电机。我建议的学习顺序是先用TIM做1秒定时中断在中断里翻转LED然后用TIM输出PWM调节LED亮度最后用TIM的输入捕获功能测量超声波模块的回波时间。这三步走完你对定时器的理解就到位了。4.4 别急着上RTOS裸机跑明白了再说很多教程一上来就教你移植FreeRTOS或者RT-Thread但对于刚接触STM32的人来说裸机编程才是打基础的关键。裸机状态下你需要自己管理中断优先级、自己写状态机、自己处理时序这些经验在上了RTOS之后依然有用。等你裸机能写出一个完整的多任务程序比如同时处理按键、串口、定时任务并且对中断嵌套、临界区保护这些概念有实际体会了再上RTOS会顺畅很多。否则你只是学会了调用RTOS的API但底层发生了什么完全不清楚。5. 那些教程里不会写但实际会遇到的坑5.1 延时函数delay卡死多半是中断优先级的问题很多人用SysTick做延时函数在main里调用没问题但一放到中断服务函数里就卡死。原因是SysTick的中断优先级默认比较低如果在高优先级中断里调用delaySysTick中断进不来计数器不增加delay就一直等。解决办法有两个一是把SysTick的中断优先级设到最高二是delay函数里不用中断直接读SysTick的当前值做轮询。我一般用第二种更可靠。5.2 串口发送数据丢失检查TC和TXE标志位的区别USART_SendData之后很多人用while(USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET)来等发送完成。TC是“传输完成”标志TXE是“发送数据寄存器空”标志。如果你用TXE来判断连续发送时可能上一个字节还没发完就往数据寄存器里写下一个导致数据被覆盖。正确的做法是发送第一个字节前等TXE发送后续字节时等TC。或者简单点每次都等TC虽然效率低一点但不会丢数据。5.3 按键抖动导致误触发硬件和软件总得解决一个机械按键按下和松开时会有5到10毫秒的抖动如果不处理按一次键程序可能检测到好几次。硬件上可以加RC滤波电路但开发板上通常没有。软件上可以在检测到按键按下后延时20毫秒再读一次确认状态一致才认为是有效按键。更好的做法是用定时器中断每隔10毫秒扫描一次按键连续三次读到相同状态才确认。这样不阻塞主循环响应也快。5.4 芯片发热严重先查有没有引脚被配置成了推挽输出但接了地STM32的推挽输出引脚如果被配置成输出高电平但外部被短接到地会有几十毫安的电流灌入引脚芯片会发烫。检查方法很简单写一个程序把所有GPIO都配置成输入浮空模式如果芯片不烫了说明是某个输出引脚的问题。然后逐个配置成输出看哪个引脚一配置就发烫就能定位到问题。5.5 程序下载后不运行先看BOOT引脚再看复位电路除了前面说的BOOT0必须接地之外还要检查复位引脚NRST的电压。正常工作时NRST应该是高电平3.3V如果一直是低电平芯片就一直在复位状态。有些板子的复位电路设计有问题电容漏电导致NRST电压被拉低。用万用表量一下NRST对地的电压如果是0V或者很低就是复位电路的问题。6. 给不同基础的朋友几条实在的建议如果你是完全零基础连C语言指针都不太熟我建议你先花一周时间把C语言的基础补一下重点是指针、结构体、位操作。STM32的库函数里大量使用了结构体指针和位运算这些不熟的话看代码会很吃力。如果你有51单片机的基础那上手会快很多。GPIO、定时器、中断这些概念是相通的主要区别在于STM32的时钟配置更复杂、外设寄存器更多。建议你从标准库的例程开始先跑通再改改着改着就理解了。如果你是为了做毕业设计或者项目时间比较紧那我建议你直接上STM32CubeMX加HAL库。图形化配置引脚和时钟自动生成初始化代码你只需要在生成的框架里填业务逻辑就行。虽然底层细节了解得少一些但出活快。不管你属于哪种情况有一件事是共通的动手写代码别光看教程。看十遍视频不如自己写一遍代码、调一次bug。STM32的学习曲线确实比51陡但一旦跨过那个坎后面就是一马平川。我在实际带新人的过程中发现大部分人卡住的地方其实就那么几个时钟没配对、BOOT引脚没拨对、下载器配置错了、中断优先级搞混了。这些问题在教程里往往一笔带过但实际遇到的时候能卡你好几天。希望这篇内容能帮你把这些坑提前填上让你把精力花在真正有意思的地方——写出能跑的程序做出能动的项目。