看到stm32-103的开发板买回来了这个标题,我是真有点感慨。STM32F103这个系列我前后用了快十年,从刚毕业时拿着最小系统板反复点灯,到现在各种项目里批量跑FOC和CAN通信,这芯片算是被我摸透了。既然你板子已经到手,别急着照着网上的视频一帧一帧抄代码,先把后面几个关键节点理顺,能省下你大半个月的弯路。这篇文章就是给刚把STM32F103开发板抱回家的人写的,不管你是学生、转行做嵌入式的,还是工作后想补硬件的软件工程师,只要你手里有板子、电脑能联网、愿意花时间折腾,这篇内容就适合你。我会从板子验收、环境搭建、最小系统认知,一直讲到定时器、ADC、CAN、电机驱动这类进阶专题,最后把新手最容易踩的坑挨个扒一遍。这些东西不指望你一天看完,但建议你收藏起来,每走一步回来翻一次。1. 板子到手,先别急着烧代码1.1 上电前的硬件检查,十分钟能避免炸板STM32F103开发板到手,第一步不是打开Keil,而是先把板子翻过来看丝印。F103系列常见的封装有LQFP48(对应C8T6、CBT6)、LQFP64(对应RCT6、RBT6)、LQFP100(对应ZET6、ZGT6),不同封装引脚数量不同,但第一个引脚的位置确认方法是通用的:芯片一角有圆形凹陷或斜切标记,以这个角为原点,逆时针方向依次是Pin1、Pin2……对着数据手册的引脚图核一遍,基本就不会插错。注意:第一次上电前,用万用表蜂鸣档测一下3.3V和GND之间有没有短路。很多廉价开发板焊接工艺一般,焊锡桥连是常见问题,一上电电源芯片直接冒烟。检查完供电引脚,再看板载调试器。现在大多数F103开发板集成ST-Link或DAP-Link,如果板子上有CH340/CP2102这类串口芯片,同样确认驱动是否有问题。我之前接过一块二手板子,板载ST-Link的固件是坏的,插上电脑毫无反应,最后只能用外置ST-Link飞线刷回去。这个情况不算罕见,后面单独讲。1.2 芯片包安装,Keil认不出芯片的元凶很多人兴冲冲打开Keil新建工程,发现Device列表里搜不到STM32F103C8T6,第一反应是软件装错了,其实是芯片支持包(Device Pack)没装。Keil MDK本体只是个编译器壳子,具体芯片的寄存器定义、启动文件、Flash算法全都放在Pack里。安装方法有两种:第一种是在Keil内点击Pack Installer图标,在线搜索STM32F1系列安装,但服务器在境外,网络差的时候能卡半天;第二种是去Keil官网下载DFP(Device Family Pack)离线包,双击安装,几秒钟搞定。要注意版本,新版DFP动辄几百MB,包含F0到F7全系列,如果你的硬盘吃紧,建议找旧版单独的STM32F1xx_DFP。装完Pack后再看工程模板。标准库和HAL库的工程结构完全不同,库文件路径、启动文件选择、宏定义都有差异,这里先按住不表,下一节专门拆。安装芯片包这个坑,百度一搜能搜出几千条求助帖,但九成都是没装Pack或装了没重启Keil,不信你试试。2. 环境选型,一条路走到黑2.1 Keil MDK、VSCode和PlatformIO,谁是你的第一选择开发环境这条路上,新手最常见的纠结就是Keil和VSCode选哪个。我的观点很直接:第一块F103板子,老老实实用Keil MDK。原因很简单,STM32的老教程、老代码、你遇到问题时的搜索引擎结果,90%都是基于Keil的。Keil的调试器界面虽然丑,但查看寄存器、断点、变量监控这些功能对新手极其友好,不用配置任何东西,装上就能用。VSCode这边,通过EIDE插件或PlatformIO也可以搭建STM32开发环境,代码补全、Git管理、主题颜值全面碾压Keil。我现在的日常开发就在VSCode里完成,配合J-Link的调试配置也能正常跑断点。但注意,VSCode需要自己配置编译器路径、烧录命令、调试器配置(launch.json),每一步都是坑。对第一次接触嵌入式的朋友,这些额外负担完全没有必要。PlatformIO则是另一个选择,它对Arduino生态非常友好,但对STM32裸机开发,同样需要自己折腾框架和烧录配置。我的建议是:先用Keil把基础概念学清楚,三个月后再看VSCode和PlatformIO,那时你对编译、链接、下载的理解足以撑起这些工具的配置。如果一上来就All in VSCode,很容易被环境问题劝退,板子吃灰的概率极高。2.2 标准库和HAL库,到底学哪个标准库(Standard Peripheral Library)直接操作寄存器结构体,代码执行效率高,寄存器层级烂熟于心;HAL库(硬件抽象层)封装了寄存器操作,提供统一的API,换芯片平台时移植方便,但代码量大、执行效率相对低、BUG也不少。这个问题几乎每周都有人在群里吵。我个人的建议是:F103作为入门芯片,标准库是首选。为什么?因为F103是Cortex-M3内核,寄存器数量远少于F4/H7系列,标准库的代码量也不算大,对着数据手册看寄存器定义,很容易建立寄存器-外设-行为的完整认知。比如配置GPIO,标准库要你自己拼GPIO_InitTypeDef的各个字段,而HAL库一上来就是HAL_GPIO_Init,黑盒程度更高。但如果你看代码手头的资源全是HAL,或者后续想做毕业设计、快速出成果,那直接学HAL也行。现在ST官方新出的CubeMX工具就是配合HAL库用的,图形化配置时钟、引脚复用,自动生成初始化代码,确实香。我的经验是:标准库适合打底,理解内核和外设的原理;HAL库适合做产品原型,迭代速度快。两者并不冲突,但第一遍学习,选一个主线走到底,别今天标准库明天HAL,会把自己绕晕。2.3 新建工程模板与LD文件的意义新建F103的工程,听起来简单,实际踩坑的人特别多。关键在于你需要同时搞定:启动文件(startup_stm32f10x_hd.s)、链接脚本(STM32F103C8Tx_FLASH.ld)、宏定义(STM32F10X_HD)、标准库的core支持文件。我用标准库举例,一个可用的工程目录至少包含这些:Project/ ├── Core/ │ ├── inc/ │ └── src/ ├── Drivers/ │ ├── CMSIS/ // 内核寄存器定义 │ └── STM32F1xx_HAL_Driver/ // 外设驱动源码 ├── startup/ // 启动文件 └── .ld // 链接脚本这里重点说一下LD文件。很多新手不知道这个文件是干嘛的,其实它控制着代码段、数据段、堆栈在Flash和RAM中的布局。比如F103C8T6的Flash是64KB,RAM是20KB,如果工程在Debug或Release模式下的地址范围超过了这个界限,链接就会报错。我遇到过有人改了编译优化等级后突然跑飞,查了一晚上,竟然是LD文件里堆栈大小与中断向量表冲突。改这个文件要谨慎,但至少要读懂里面几个关键参数的含义。3. 第一周的目标:点灯、按键与串口,建立最小系统认知3.1 GPIO操作,点亮第一盏灯的完整链路STM32点灯这个经典操作,拆开来看其实包含了整个嵌入式开发的底层逻辑。以标准库为例,要点亮PA1引脚上的LED,需要三步:开启GPIOC的时钟、配置引脚模式、设置引脚电平。缺一不可,而这三步对应的原理就是:STM32的每个外设默认电源关闭,必须先通过RCC(复位与时钟控制)使能时钟,才能访问寄存器。我在代码里习惯这样写:// 开启GPIOC时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_1; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; // 推挽输出 GPIO_Init(GPIOC, GPIO_InitStructure); // 拉低引脚,点亮LED(取决于板子电平逻辑) GPIO_ResetBits(GPIOC, GPIO_Pin_1);为什么推挽输出?因为推挽模式下引脚既能输出高电平也能输出低电平,带负载能力强,驱动LED最合适。如果是开漏输出,还得外接上拉电阻,新手容易搞混。引脚速度设置成50MHz是指IO口的翻转速率上限,不是实际频率,这个参数不影响LED点亮,但在I2C、SPI这类高速通信时就得注意匹配。3.2 按键输入与延时函数,这两个坑天天有人踩按键输入的关键是配置输入模式和消抖。GPIO_Mode_IPU(上拉输入)和GPIO_Mode_IPD(下拉输入)的区别,取决于你的按键接线是接GND还是接3.3V。按键按下后,引脚电平会有几十毫秒的机械抖动,直接读取会读到大量跳变,必须软件延时消抖。正确流程:检测到引脚电平变化→延时20ms→再读一次,确认电平,再执行功能。延时函数这块,新手最爱用的是for循环空转,比如for(i0;i100000;i);。这在编译器优化级别低的时候勉强能用,一旦打开-O2优化,循环可能被整体优化掉,延时直接失效,代码表现就是灯闪得太快或者完全没反应。更严重的情况是,你在中断里用了带延时的函数,程序直接卡死。这个问题在下午Delay卡死排查部分会专门讲。正确的做法是使用SysTick系统滴答定时器,它是Cortex-M3内核自带的24位倒计时定时器,专门用来产生固定时基。标准库中有Delay_Ms(u16 nms)这种函数,底层就是调SysTick。HAL库中则有HAL_Delay(),注意HAL_Delay在中断上下文调用会死锁,这是HAL库的一个坑,处理方法后面表格里列。3.3 串口通信,UART管脚定义与printf重定向串口是STM32调试的命脉,也是新手第一个接触的通信协议。以F103C8T6为例,USART1的TX/RX默认映射在PA9/PA10,USART2在PA2/PA3,但注意,这些引脚还可以重映射到其他端口,比如通过AFIO寄存器把USART1搬到PB6/PB7。如果你看到别人代码里用的是PB6/PB7,而你的板子默认接PA9/PA10,通信不上是必然的。串口配置看似简单,波特率、数据位、停止位、校验位几个参数,实际上波特率误差是常见问题。F103的USART时钟来自APB2总线,如果系统时钟72MHz,USART1的波特率寄存器配置才能得到精确值;如果系统时钟被你误配成8MHz(内部HSI),同一个波特率寄存器值对应的实际波特率就完全不对了,表现就是串口助手收到的全是乱码。printf重定向这个操作,本质是把标准输出fputc函数指向串口发送寄存器,让单片机通过串口打印日志。这个操作需要包含stdio.h并实现:int fputc(int ch, FILE *f) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, (uint8_t)ch); return ch; }但很多人在这之后发现串口输出的中文在PC端变成乱码,这是因为编辑器默认编码和串口助手的解码不一致。ST官网的例程注释出现乱码就是这个原因。中文乱码的罪魁祸首是GD32或国产芯片串口波特率偏差较大,以及上位机软件默认的编码格式不匹配。解决办法就是统一下位机发送UTF-8、上位机接收选UTF-8,或者反过来都是GBK,总之要一致。4. 高频外设专题:定时器、ADC与总线通信4.1 定时器捕获测频率,这个需求很典型STM32定时器捕获测频率是搜索热度很高的关键词,应用场景包括风扇转速测量、PWM信号解码、编码器计数。F103的定时器捕获测频率原理是:外部信号从定时器的捕获输入引脚进入,定时器在信号边沿到来时自动锁存当前计数值,你通过相邻两次捕获值之差,就能算出信号周期,再取倒数就是频率。这里有个关键点叫预分频器。定时器时钟来自APB1(36MHz)或APB2(72MHz),你要通过预分频把计数时钟分到一个合理的频率。比如测1kHz到100kHz的方波,如果计数时钟是72MHz,每个周期能计72000个数,精度足够;但如果测的是1Hz的信号,计数周期就得拉长,否则计数器早就溢出了。定时器位宽是16位,最大计数65535,这是硬件限制,超了就要用溢出中断配合扩展计数。实操中遇到的典型问题:输入捕获通道配置错误,导致捕获值恒为0或者恒为最大值。F103的TIM2、TIM3、TIM4是挂在APB1上的,而TIM1是挂在APB2上,两者时钟源频率不同。如果你在初始化时把TIM1的预分频设置成与TIM2一致,捕获值会差一倍。4.2 ADC中断采集,多通道模拟量处理要点ADC(模数转换器)在传感器项目中几乎是标配,比如通过光敏电阻测光照、通过电位器测角度、通过NTC测温度。F103的ADC是12位的,转换结果范围0~4095,对应参考电压3.3V的0~3.3V。ADC中断和DMA是两回事。中断是每转换一次触发一次,适合低频采样;DMA是转换结果直接搬进内存,CPU完全不参与,适合连续采集多通道。如果你的项目里同时采集三个通道的电压,我建议直接上ADCDMA,初始化一次,DMA自动把三个通道的结果轮流存入数组,主循环直接读数组就行,省心。ADC采样不稳定是新手的噩梦。表现为读数跳动、偏离真实值。原因通常是:参考电压VREF不稳定、采样时间太短、引脚悬空或输入阻抗过高。我调试时习惯在采样前加几次空转换,让ADC内部电容充放电稳定,这个方法虽然土,但非常见效。4.3 CAN通信突然连不上的排查思路STM32F103自带CAN控制器,应用在汽车电子、工业控制、传感器网络这些场景中极其广泛。CAN通信与UART最大的区别是:它走的是差分信号,靠CAN_H和CAN_CAN_L两条线的电压差表达逻辑电平,所以抗干扰能力强,但是物理层必须有CAN收发器芯片(如TJA1050、MCP2551)把TTL电平转换成差分信号。CAN通信突然连不上这个问题我遇到太多次了,而且几乎每次原因都不一样。最典型的几种情况:终端电阻问题:CAN总线两端必须各接一个120欧姆终端电阻,用来匹配阻抗、吸收反射。只有一个节点调试时,至少在收发器旁边跨接一个120Ω电阻,否则波形振铃严重,通信时好时坏。波特率不匹配:CAN的波特率由分频器时间段1时间段2组合决定,双方设置必须严格一致。我用逻辑分析仪抓过波形,发现论坛上抄来的配置,有的其实差了1%。总线繁忙:CAN总线是仲裁机制,如果总线上某个节点一直在发错误帧,它会持续拉低总线,导致其他节点都发不出去,表现就是连不上。解决办法是断开所有节点,只留一个,逐点排查。收发器芯片损坏:这是物理层的坑,用万用表测CAN_H和CAN_L之间的静态电阻,正常应该在60Ω左右(两个120Ω并联),如果开路或短路,基本就是收发器挂了。4.4 用F103做USB设备,门槛没有想象中高STM32如何做USB设备也是高频搜索词。F103的USB是USB 2.0 Full Speed(12Mbps),可以作为HID设备、虚拟串口(CDC)、U盘(MSC)等。很多人以为USB开发很难,其实ST官方提供了USB固件库,只需要填充描述符和端点回调函数就行。我用F103做过一个HID键盘,代码量不大,核心就是配置USB中断、填写设备描述符、定义报表描述符。但有个细节:USB的D引脚要接1.5kΩ上拉电阻到3.3V,用来通知主机设备已连接。很多开发板把这个电阻做进去了,但如果你自己画板子,漏了这个电阻,USB永远枚举不上。USB工程的时钟配置也需要特别注意。F103的USB模块需要一个精确的48MHz时钟,这个时钟通常来自PLL输出。如果你系统主频改过,USB时钟就偏了,枚举阶段就会失败。我在调试USB HID时,经常遇到枚举失败的问题,后来发现是CubeMX配置时钟树时,USB预分频器设置错误。5. 从专题到项目,热门方向这么选5.1 显示类:OLED与ILI9341屏幕显示是人机交互的基础。I2C接口的OLED(SSD1306)是新手最常接触的,而SPI接口的TFT屏幕(ILI9341)则是进阶选择。ILI9341支持最大320x240分辨率,读取ID寄存器可以确认屏幕驱动是否正确初始化。stm32使用ili9341读id是a1a1这个问题被反复搜索,我猜很多人跟我一样,在这个坑里蹲过。ILI9341的读ID指令是0x04,正常返回值应该是0x9341或者0x0000,如果读到0xA1A1,说明屏幕的SPI模式配置有误。最常见的原因:屏幕的IM模式引脚决定它工作在SPI还是8080并口模式,如果你的板子上的IM0~IM3引脚被设定为8位并口模式,SPI读命令自然返回0xA1A1。解决办法是检查屏幕型号对应的IM引脚电平,改成4线SPI模式。另外,SPI读取时要先发送一个字节的命令,然后发送Dummy字节(通常是0x00),再读数据,时序错一个字节也可能得到0xA1A1。BH1750光照传感器I2COLED这个组合是课设经典题目,网上完整原理图一大把。但需要留意的坑是I2C上拉电阻:STM32的I2C开漏输出必须接上拉电阻才能工作,很多面包板实验漏接上拉,导致I2C通信时好时坏。5.2 电机类:步进电机、伺服与两轮差速小车五线四相步进电机stm32这个题目,对应的是28BYJ-48这个型号,它是5线4相步进电机,驱动方式比较特殊,必须用ULN2003驱动板,而不能直接接STM32的引脚。五线四相的工作方式是:四相绕组依次通电,产生步进转动。完整的驱动时序有8拍(半步)和4拍(全步)两种,8拍方式步距角更小、转动更平稳。电机控制方向后期很容易走火入魔,从步进电机到stm32控制伺服电机485,会遇到Modbus RTU通信协议,对应的开源库有agile_modbus。这个库我用过,移植到STM32上不算难,但要注意485收发切换的延时,TX转RX方向时必须给足时间(至少3.5个字符时间),否则第一个回包会丢失。两轮差速小车是整个电机知识体系的集大成者——左右轮各一个直流减速电机,通过PWM控制速度,通过编码器测速,再做PID闭环,最终实现直行、转向、循迹。这个项目把GPIO、定时器、PWM、外部中断、串口全串起来了,如果你想把基础外设融会贯通,我强烈推荐做个两轮差速小车。注意PID参数整定没有秘诀,先给纯比例(P),增大到系统开始振荡,再取当前值的60%作为P值,然后加积分消除静差,最后加微分抑制超调,这个流程很老套,但管用。5.3 物联网类:巴法云、ESP8266与智能台灯stm32 巴法云这个关键词说明了现在很多人在做物联网远程控制。巴法云是一个国内物联网云平台,提供MQTT协议接入,STM32通过ESP8266 WiFi模块以AT指令连接MQTT,就能实现远程开关灯、远程读取传感器数据。我做过一个STM32ESP8266接入巴法云的项目,最核心的难点不是协议,而是数据格式。MQTT主题和报文的格式必须与平台文档完全一致,字符串编码也不能错。ESP8266的AT指令固件版本不同,指令集有差异,新版固件连接WiFi的指令是ATCWJAP,老版本是ATCWJAP,别问我是怎么知道的。根据stm32的智能台灯实际上就是这个方向套壳——光敏传感器采集环境亮度、人体感应模块检测是否有人、PWM调光控制灯亮度、ESP8266上报状态到云端。这类项目看起来复杂,拆开来就是前面所有专题的排列组合,所以我一直说:别急着做大项目,先把点灯、串口、ADC、PWM做透,组合项目自然就会了。5.4 用STM32做鱼缸控制器,这才是真实需求stm32鱼缸这个关键词看起来莫名其妙,但仔细一想,这是嵌入式开发最真实的价值所在——解决生活中遇到的具体问题。一个实用型鱼缸项目需要:DS18B20水温传感器、加热棒继电器控制、水泵PWM调速、水位检测、OLED显示,有时候还要加个定时喂食器。这类项目最大的坑是电源隔离与继电器驱动。STM32是3.3V逻辑,继电器线圈是5V或12V,必须用三极管或光耦驱动,不能直接连。而水泵、加热棒这类大功率设备的启停,会瞬间拉低电源电压,如果共地,STM32直接复位。解决方法是使用SSR(固态继电器)代替机械继电器,并做光耦隔离。我不建议新手一上来就做鱼缸,硬件布线复杂度比小车高一个量级。但如果你有养鱼的实际需求,这个项目的动力会很足,而有真实需求恰恰是学习嵌入式的最大动力,比任何教程都管用。6. 新手必踩的坑与排查实录6.1 Delay卡死问题,优先级与中断的相爱相杀stm32延时函数delay卡死这个问题我见过不下十次,而且每次的根因都不一样。最容易犯的错误是在定时器中断或外部中断服务函数里调用HAL_Delay()。HAL_Delay的实现依赖SysTick中断,而SysTick的中断优先级如果设置得比当前中断低,它就一直得不到响应,HAL_Delay里的uwTick变量永远不更新,死循环出不来。另一个容易踩的是标准库的Delay函数里关闭了中断。我之前接手过一个项目,别人的Delay函数一进来就关全局中断,延时结束后再开,如果操作顺序写反,中断永远打不开,所有依赖中断的外设全部瘫掉。排查方法是先检查中断优先级分组是否配置正确,再确认延时函数是否在中断上下文被调用。6.2 芯片第一脚确认与JTAG禁用,两个最基础又最致命的细节芯片第一脚确认这个问题,前面说过一半。确实有人把芯片焊反了,或者跳线帽插反导致3.3V和GND互换,一旦上电,不仅芯片完蛋,还可能波及ST-Link。我用两个方法双保险:一是看丝印小圆坑,二是用万用表二极管档测电源脚和地脚之间的压降,正常0.3V左右,如果反了就立刻断电。stm32禁用jtag这个问题,根源在于很多新人发现PB3、PB4、PA15这几个引脚怎么配置都不受控,查数据手册才发现它们是JTAG调试接口的复用引脚。当你在初始化GPIO时,如果不把JTAG复用关闭,这几个引脚始终被调试器占用。关闭方法是用AFIO重映射函数:GPIO_PinRemapConfig(GPIO_Remap_SWJ_Disable, ENABLE);但注意,把JTAG完全禁用后,你的ST-Link就再也连不上芯片了,除非把BOOT0拉高进入ISP模式擦除整个Flash。所以我建议只关闭JTAG、保留SWD:GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);这个配置保留SWD两根线,ST-Link还能继续调试下载,只是PB3/PB4/PA15这3个引脚被释放给普通GPIO用。6.3 ILI9341读ID 0xA1A1、CAN连不上等高频故障速查这一节我直接整理成一个速查表,把高频故障和排查方法放在一起,方便你遇到问题时对号入座。故障现象常见原因首选排查方法ILI9341读ID返回0xA1A1IM模式引脚电平不对,SPI时序错误检查屏幕IM0~IM3电平配置,核对SPI模式与Dummy字节CAN通信突然失效终端电阻缺失/波特率不一致/总线被错误帧占用万用表测CAN_H与CAN_L间电阻,断开所有节点逐个排查Delay卡死中断内调用HAL_Delay/SysTick优先级配置错误检查SYSTICK中断优先级,避免中断内调用阻塞延时串口乱码波特率不匹配/时钟源配置错误/编码不一致用示波器或逻辑分析仪抓TX引脚波形,核对波特率ST-Link连接失败板载调试器固件损坏/SWD引脚被复用/芯片锁死检查驱动,短接RST引脚再连接,必要时ISP擦除ADC读数跳动参考电压不稳/采样时间过短/引脚悬空增加采样时间,加RC滤波电容,先空转换几次五线四相步进电机不转驱动时序错误/ULN2003没供电逐项测试八拍时序,确认电机绕组通断最后再分享两个小技巧,这两个是常规教程不会讲的。第一个是底层寄存器查看:Keil调试时在Watch窗口输入*(volatile unsigned long*)0x40010800就能直接读GPIOC的配置寄存器,排查引脚配置问题比看结构体变量直观得多。第二个是防止芯片锁死的最终手段:把BOOT0跳到1,上电后运行程序不会执行,此时可以用串口ISP或ST-Link全片擦除来救砖。我在实际使用中最大的体会是:STM32F103这个芯片的最大价值不是性能,而是它庞大的学习生态。不管你想做USB设备、超声波测距、FOC电机控制,还是刷网页版的MQTT物联网项目,都能找到前人的脚印。所以你手上这块板子,其实就是一把打开嵌入式世界的钥匙。别急着问下一步学什么,先把自己想做的那个具体小东西列出来,哪怕是给鱼缸加个温度控制,对着这条线把外设一个个点亮,等你能把一个不抄教程的完整小项目跑通,那种成就感比水一百篇教程都强。