1. 拿到板子先别急着点灯搞懂STM32F103到底是个啥STM32F103这块板子在嵌入式圈子里基本等同于“驾照里的C1”——你可以不开车但你不能不会。我前后带过不下二十个新手入门发现一个特别有意思的现象八成以上的人拿到板子第一件事就是找例程、烧代码、看点灯结果卡在环境配置上三天动弹不得热情直接浇灭一半。所以这篇东西我不打算按教科书的路子讲而是把我自己踩过的坑、带人时遇到的典型问题按实际操作的顺序捋一遍。STM32F103是意法半导体基于ARM Cortex-M3内核的32位微控制器常见型号有C8T6、RCT6、ZET6等区别主要在Flash容量、RAM大小和引脚数量。C8T6是64引脚、64KB Flash、20KB RAMZET6是144引脚、512KB Flash、64KB RAM。新手最常买的是C8T6最小系统板或者ZET6的开发板前者便宜小巧适合练手后者外设全适合做项目。这块芯片的主频最高72MHz内置ADC、定时器、USART、SPI、I2C、CAN、USB等外设基本上你能想到的嵌入式功能它都有。为什么新手入门选F103而不是别的原因很实在资料多、价格低、生态成熟。你遇到任何问题搜一下基本都能找到答案。相比之下一些新出的芯片虽然性能强但中文资料少新手卡住了连问的人都找不到。F103的标准库和HAL库都极其成熟标准库更贴近寄存器适合理解底层原理HAL库封装度高适合快速开发。我的建议是先用标准库把基本原理搞明白再转HAL库做项目这样基础扎实。适合看这篇内容的人刚拿到STM32开发板不知道从哪下手的新手、学过51单片机想进阶的、电子类专业需要做课程设计或毕业设计的、工作中需要用到STM32但之前没系统学过的。如果你已经能熟练用F103做项目了这篇可能对你帮助有限但里面的一些调试技巧和避坑经验或许还是有点用。2. 开发环境搭建别在第一步就卡住2.1 Keil还是VS Code选哪个不纠结这个问题我被问过无数次。直接说结论新手先用Keil MDK别折腾VS Code。原因很简单Keil是STM32开发的传统工具链安装包、芯片包、例程、教程全都是配套的你遇到问题搜到的答案大概率也是基于Keil的。VS Code配置STM32开发环境需要自己装编译器、配调试器、写launch.json和tasks.json对新手来说光是这些配置文件就能劝退。但VS Code也不是没有优势。它的代码编辑体验比Keil好太多自动补全、语法高亮、Git集成都更现代。我自己的做法是用Keil做编译和调试用VS Code写代码通过插件或者外部编辑器的方式联动。具体操作是在Keil里设置外部编辑器为VS Code这样双击源文件就用VS Code打开保存后回到Keil编译。这个方案兼顾了两者的优点配置也不复杂。如果你坚持要用VS Code从头搭环境需要装的东西包括ARM GCC工具链、OpenOCD或J-Link驱动、Cortex-Debug插件然后手动编写launch.json配置调试参数。这个过程我在后面会详细说但真心建议新手先把Keil用熟了再折腾这些。2.2 Keil安装与芯片包配置的坑Keil MDK的安装本身不复杂去官网下载安装包一路下一步就行。但有几个地方需要注意安装路径不要有中文和空格否则后面编译可能出各种莫名其妙的错误。安装完成后需要单独安装STM32F1的芯片包这个包叫Keil.STM32F1xx_DFP去Keil官网或者国内镜像下载都行双击安装即可。这里有个常见问题很多人装完Keil发现新建工程时找不到STM32F103的型号。原因就是芯片包没装或者装错了版本。芯片包分F0、F1、F2、F3、F4、F7、H7等系列你要学F103就得装F1系列的包。另外如果你同时要开发51单片机Keil C51和MDK可以装在同一台电脑上但要注意安装顺序——先装C51再装MDK否则C51的注册信息可能被覆盖。这个问题在热词里也有人提到确实是个高频坑点。还有一个容易被忽略的点Keil的版本。现在最新的是Keil MDK 5.x系列但有些老教程用的是Keil 4界面和操作都有差异。建议直接用MDK 5社区版免费功能对学习来说完全够用。安装完成后记得安装对应的器件支持包否则编译时会提示找不到设备头文件。2.3 烧录工具怎么选ST-Link、J-Link还是串口烧录工具的选择取决于你手上的开发板。大多数STM32F103开发板都板载了ST-Link或者提供了SWD接口。ST-Link是官方工具便宜好用支持SWD和JTAG两种调试接口。J-Link性能更强支持更多芯片型号但价格也更高。如果你只是学F103ST-Link完全够用。串口下载是另一种方式通过BOOT0和BOOT1引脚设置启动模式用USB转TTL模块连接USART1下载程序。这种方式不需要额外的调试器但每次下载都要手动切换BOOT引脚比较麻烦而且不能在线调试。我的建议是买板子的时候直接选带ST-Link的套餐省心很多。这里要特别提一下热词里出现的“stm32禁用jtag”问题。STM32的PA13、PA14、PA15、PB3、PB4这几个引脚默认是JTAG功能如果你想把它们当普通IO用需要禁用JTAG或者复用为SWD。具体操作是通过AFIO的MAPR寄存器配置或者直接在代码里调用GPIO_PinRemapConfig函数。这个坑我在做项目时踩过当时想把PB3当普通输出用结果怎么配置都不对后来查手册才发现是JTAG占用的问题。3. 第一个工程从建工程到点灯每一步都说清楚3.1 新建工程的标准流程打开KeilProject - New uVision Project选择保存路径。路径同样不要有中文和空格。然后选择芯片型号搜索STM32F103根据你板子上的具体型号选择比如STM32F103C8、STM32F103ZE等。选完后会弹出一个对话框问你是否加载启动文件点“是”。接下来需要手动添加文件到工程。一个标准的STM32F103工程至少需要以下几类文件启动文件startup_stm32f10x_hd.s或md.s根据芯片容量选择、系统文件system_stm32f10x.c、内核文件core_cm3.c和core_cm3.h、标准外设库文件stm32f10x_gpio.c、stm32f10x_rcc.c等、头文件路径配置。这些文件可以从ST官方的标准外设库中获取网上也有很多打包好的工程模板可以直接用。对于新手我建议先用现成的工程模板把点灯跑通建立信心后再自己从头建工程。现成模板可以在各种STM32论坛和GitHub上找到搜索“STM32F103标准库工程模板”就有很多。用模板的好处是省去了配置头文件路径、添加库文件这些繁琐步骤直接写业务代码就行。3.2 GPIO点灯代码详解点灯的本质是控制GPIO输出高低电平。STM32的GPIO有8种模式输入浮空、输入上拉、输入下拉、模拟输入、开漏输出、推挽输出、开漏复用、推挽复用。点灯用推挽输出就行这种模式可以输出强高低电平驱动LED没问题。代码分三步使能GPIO时钟、配置GPIO模式、控制输出电平。使能时钟是因为STM32的外设默认不供电用之前必须先开时钟这个设计是为了省电。配置GPIO用GPIO_Init函数传入结构体参数。控制电平用GPIO_SetBits和GPIO_ResetBits或者直接操作ODR寄存器。#include stm32f10x.h void LED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOC, GPIO_InitStructure); GPIO_SetBits(GPIOC, GPIO_Pin_13); } int main(void) { LED_Init(); while(1) { GPIO_ResetBits(GPIOC, GPIO_Pin_13); for(int i 0; i 1000000; i); GPIO_SetBits(GPIOC, GPIO_Pin_13); for(int i 0; i 1000000; i); } }这段代码里GPIOC的时钟挂在APB2总线上所以用RCC_APB2PeriphClockCmd。如果是GPIOA或GPIOB也是APB2。但如果是USART2、USART3这些挂在APB1上的外设就要用RCC_APB1PeriphClockCmd。这个细节新手很容易搞混记不住就查参考手册的时钟树图。延时用for循环是权宜之计实际项目中要用定时器或者SysTick。for循环延时的缺点是时间不精确编译器优化等级不同、主频不同都会影响延时长度。但在点灯这个阶段能用就行先跑通再说。3.3 编译烧录与常见报错处理编译快捷键是F7烧录是F8。如果编译报错常见原因有头文件路径没加、库文件没添加到工程、启动文件选错了容量型号、中文路径导致编译器找不到文件。热词里有个报错信息“load ... project.axf error: flash download failed”这个通常是烧录器连接问题或者Flash算法没配置。检查ST-Link驱动是否安装、SWD线是否接好、Keil的Debug设置里是否选对了烧录器型号。烧录时如果提示“No Cortex-M Device found”先检查板子是否上电、SWD接口的SWCLK和SWDIO是否接反、复位引脚是否被拉低。有时候ST-Link的固件版本太老也会导致识别不到芯片用ST-Link Utility升级一下固件就好。还有一个高频问题程序烧进去了但板子没反应。先确认LED的引脚和代码里配置的是否一致再确认LED的极性——有些板子的LED是低电平点亮有些是高电平。用万用表量一下引脚电压就能判断。如果电压在变化但LED不亮可能是限流电阻太大或者LED焊反了。4. 进阶外设定时器、串口、ADC怎么玩4.1 定时器不只是延时那么简单STM32F103有多个定时器高级定时器TIM1和TIM8、通用定时器TIM2到TIM5、基本定时器TIM6和TIM7。定时器的核心是计数器和预分频器通过配置ARR和PSC两个寄存器来决定定时周期。计算公式是定时时间 (ARR1) × (PSC1) / 时钟频率。比如时钟72MHzPSC7199ARR9999定时就是(99991)×(71991)/72000000 1秒。定时器可以做延时、PWM输出、输入捕获、编码器接口等。PWM控制电机和LED亮度输入捕获测频率和脉宽编码器接口读旋钮。热词里提到的“stm32定时器捕获测频率”和“stm32超声波测距”都是定时器的典型应用。超声波测距就是用定时器捕获回波信号的高电平时间再乘以声速除以2就是距离。配置定时器中断的步骤使能时钟、配置时基结构体、配置中断优先级、使能中断、写中断服务函数。中断服务函数的名字在启动文件里已经定义好了你只需要在代码里实现同名函数就行。比如TIM2的中断函数叫TIM2_IRQHandler。中断里记得清除中断标志位否则会反复进中断。4.2 串口通信调试和通信两不误串口是嵌入式开发中最重要的调试手段。STM32F103有3个USART和2个UARTUSART1挂在APB2USART2和USART3挂在APB1。配置串口需要设置波特率、数据位、停止位、校验位、流控。常用配置是115200-8-N-1即波特率115200、8位数据、无校验、1位停止位。串口发送用USART_SendData接收用中断或轮询。中断接收的流程是使能接收中断、在中断服务函数里判断RXNE标志、读取数据、清除标志。串口接收大量数据时建议用DMA可以减轻CPU负担。热词里的“stm32 串口接收”和“stm32 com事件示意图”都是串口相关的常见问题。printf重定向是串口调试的常用技巧。在Keil里需要重写fputc函数把字符输出重定向到串口。具体做法是实现int fputc(int ch, FILE *f)函数在里面调用USART_SendData然后等待发送完成。还要在Keil的设置里勾选“Use MicroLIB”否则printf可能不工作。4.3 ADC采样从电位器到传感器ADC是把模拟信号转成数字信号的外设。STM32F103有3个ADC12位精度最多18个通道。配置ADC的步骤使能时钟、配置GPIO为模拟输入、配置ADC结构体、校准、使能、触发转换、读结果。ADC的参考电压通常是3.3V12位精度意味着最小分辨率为3.3/4096≈0.8mV。ADC采样要注意几点采样时间要足够长否则采样不准输入阻抗不能太高否则需要加电压跟随器参考电压要稳定否则读数会跳动。如果读数波动大可以在软件里做多次采样取平均或者加RC滤波电路。热词里的“stm32 bh1750 oled i2c proteus完整原理图”涉及I2C通信和OLED显示。BH1750是光照传感器通过I2C接口读光照强度再显示到OLED上。这个项目综合了I2C、OLED驱动、传感器读取适合练手。I2C的配置比串口复杂一些需要理解起始信号、停止信号、应答信号、时钟同步等概念。建议先用软件模拟I2C搞懂时序后再用硬件I2C。5. 调试技巧与常见问题排查5.1 程序跑飞了怎么办程序跑飞是新手最头疼的问题之一。常见原因有数组越界、指针未初始化、堆栈溢出、中断优先级配置错误、时钟配置错误。排查方法先用调试器单步执行看程序停在哪里再检查变量值是否异常最后用串口打印关键信息辅助定位。HardFault是Cortex-M内核的异常通常由非法内存访问或未定义指令引起。发生HardFault时可以通过查看LR寄存器的值判断是在中断里还是在主程序里出错。更详细的分析需要查看CFSR、HFSR、MMFAR、BFAR等寄存器。这些寄存器在Keil的Register窗口里能看到。看门狗是防止程序跑飞的最后一道防线。独立看门狗IWDG用内部低速时钟窗口看门狗WWDG用APB1时钟。配置好看门狗后程序必须在规定时间内喂狗否则看门狗复位芯片。调试时可以先禁用看门狗等程序稳定了再启用。5.2 延时函数卡死的原因热词里“stm32延时函数delay卡死”是个高频问题。用SysTick做延时的时候如果中断优先级配置不当或者在中断里调用延时函数就可能卡死。SysTick的中断优先级默认是最低的如果其他中断长时间占用CPUSysTick中断得不到响应延时就会一直等下去。解决办法不要在中断里调用延时函数如果必须在中断里延时用简单的for循环而不是SysTick检查是否有中断没有清除标志位导致反复进中断。另外如果用了RTOSSysTick被RTOS接管了就不能再用它做裸机延时要用RTOS提供的延时函数。5.3 CAN通信突然连不上CAN总线在工业控制和汽车电子中用得很多。热词里“stm32 can通信突然连不上”也是常见问题。CAN通信失败的原因终端电阻没接CAN总线两端各需要120欧姆终端电阻、波特率不匹配、滤波器配置错误、总线负载过高、收发器供电异常。排查步骤先用示波器看CAN_H和CAN_L的差分信号是否正常再检查终端电阻是否接好然后确认两端的波特率是否一致最后检查滤波器配置。CAN的波特率计算涉及分频系数、时间段1、时间段2、同步跳转宽度等参数配置错了就通信不上。建议用CAN分析仪抓包能快速定位问题。6. 项目实战从毕业设计到实际产品6.1 基于STM32的毕业设计怎么做热词里“基于stm32的毕业设计”和“stm32报站程序完整代码”说明很多学生用STM32做毕设。毕设的关键是选题要合适太难做不出来太简单没工作量。常见的STM32毕设题目智能家居控制、环境监测、公交报站、智能小车、鱼缸控制、电子秤、密码锁等。做毕设的流程需求分析、方案设计、硬件选型、原理图绘制、PCB打样、焊接调试、代码编写、功能测试、论文撰写。时间分配上硬件和代码各占一半论文留出至少两周。代码要模块化方便调试和修改。论文要写清楚设计思路、实现方法、测试结果不要只堆代码。热词里的“stm32鱼缸”是个典型的毕设题目功能包括温度控制、自动喂食、灯光控制、水位监测、手机远程控制等。这个题目综合了传感器、执行器、通信、人机交互工作量适中适合本科毕设。6.2 从开发板到实际产品的距离开发板上跑通的代码离实际产品还有很长的路。产品要考虑功耗、EMC、温度范围、成本、可靠性、量产一致性。开发板上用的线性稳压器效率低产品里要用开关电源开发板上没有防反接保护产品里要加开发板上没有看门狗产品里必须加。低功耗设计是产品化的关键。STM32F103有睡眠、停止、待机三种低功耗模式。睡眠模式只关CPU时钟外设还在跑停止模式关所有时钟保留SRAM和寄存器待机模式功耗最低但唤醒后相当于复位。选择哪种模式取决于唤醒时间和功耗要求。PCB设计也是产品化的重要环节。STM32的晶振要靠近芯片负载电容要匹配电源引脚要加去耦电容每个电源引脚一个100nF模拟地和数字地要分开最后单点接地SWD接口要预留方便量产烧录和调试。6.3 代码优化与性能提升代码优化分几个层面编译器优化、算法优化、硬件加速。编译器优化等级从-O0到-O3等级越高代码越小越快但调试信息越少。调试阶段用-O0发布阶段用-Os或-O2。算法优化比如用查表代替实时计算、用移位代替乘除、用DMA代替CPU搬运数据。STM32F103没有硬件浮点单元浮点运算靠软件模拟速度很慢。如果项目里浮点运算多考虑用定点数代替或者用查表法。比如计算sin值可以预先算好表存在Flash里用的时候查表加插值。中断优先级配置也很关键。NVIC支持16级优先级数值越小优先级越高。高优先级中断可以打断低优先级中断。配置原则实时性要求高的中断优先级高执行时间长的中断优先级低。中断服务函数要尽量短耗时操作放到主循环里做。7. 学习路线与资源推荐7.1 从零到能做项目的学习路径第一阶段环境搭建和点灯。目标是把Keil装好、工程建好、LED点亮。这个阶段大概需要一到两天主要时间花在装软件和解决各种报错上。第二阶段GPIO、定时器、串口、中断。目标是能用这些外设做简单项目比如按键控制LED、串口收发数据、定时器精确延时。这个阶段需要一到两周重点是理解寄存器和库函数的关系。第三阶段ADC、I2C、SPI、DMA。目标是能驱动常见传感器和显示屏比如OLED、温湿度传感器、EEPROM。这个阶段需要两到三周难点是理解通信时序和DMA配置。第四阶段综合项目。目标是独立完成一个完整项目从需求到代码到调试。这个阶段需要一个月以上重点是培养工程思维和调试能力。7.2 常用工具和资源开发工具Keil MDK、STM32CubeMX、VS Code、STM32CubeProgrammer、ST-Link Utility。调试工具ST-Link、J-Link、逻辑分析仪、示波器、万用表。文档STM32F103参考手册、数据手册、Cortex-M3权威指南、标准外设库用户手册。在线资源ST官方社区、各种电子论坛的STM32板块、GitHub上的开源项目、B站上的教学视频。遇到问题先搜再问搜的时候用英文关键词往往能找到更准确的答案。7.3 常见误区与建议第一个误区只看视频不动手。看十遍视频不如自己写一遍代码。第二个误区追求最新最全的资料结果收集了一堆却一个都没看完。建议选定一套教程从头跟到尾。第三个误区遇到问题就放弃。嵌入式开发就是不断解决问题的过程调试能力比写代码能力更重要。我的建议准备一个笔记本记录遇到的问题和解决方法。这些问题以后还会遇到有记录就能快速解决。代码要经常备份用Git或者手动复制都行。调试的时候要有耐心一个问题一个问题解决不要同时改多个地方。最后分享一个我自己的习惯每次做完一个项目把代码整理成模板把常用的配置封装成函数。下次做新项目的时候直接复制模板能省很多时间。这个习惯坚持几年你就有自己的代码库了开发效率会高很多。