STM32F103开发板入门指南：从环境搭建到外设实操的完整路径

1. 拿到板子先别急着上电STM32F103开发板入门前的认知校准STM32F103这块板子大概是国内嵌入式爱好者手里保有量最大的一块ARM Cortex-M3开发板了。便宜、资料多、外设全从大学课程设计到小批量工控产品到处都能见到它的身影。但正因为太常见很多人拿到板子之后反而不知道从哪下手——插上USB线灯亮了然后呢我前后带过不少刚入行的朋友入门STM32发现一个很普遍的规律卡住新手的从来不是代码本身而是对这块板子到底能干什么、我该按什么顺序学没有清晰的认知。有人上来就想做USB设备有人第一天就研究FOC电机控制结果连GPIO都没点明白挫败感直接拉满。这篇文章面向的是刚拿到STM32F103开发板、准备系统学习的朋友。我会从板子到手后的第一件事讲起把开发环境搭建、工程模板创建、GPIO与定时器这些核心外设的实操路径、常见烧录问题排查以及后续进阶方向的选择逻辑全部拆开揉碎讲一遍。内容基于我自己用STM32F103ZET6和C8T6两块板子的实际经验也会补充一些新手最容易踩的坑和对应的解决思路。不管你是电子专业的学生、转行嵌入式的开发者还是想用STM32做毕业设计的同学只要跟着这个路径走至少能少走两三个月的弯路。2. 开发环境搭建Keil、VS Code还是STM32CubeIDE2.1 三套主流方案的真实对比新手遇到的第一个选择就是用什么IDE这个问题在论坛上吵了十几年到现在也没有标准答案。我把三套主流方案的实际使用体验列出来你根据自己的情况选。方案优势劣势适合人群Keil MDK资料最多教程遍地调试器兼容性好收费虽然有社区版编辑器体验老旧学生、跟着教程走的初学者STM32CubeIDE官方免费集成CubeMX配置工具基于Eclipse吃内存启动慢想用HAL库快速开发的工程师VS Code 插件编辑器体验最好轻量灵活配置门槛高出问题排查麻烦有一定基础的开发者我个人的建议是如果你是完全零基础先用Keil把第一个工程跑通。不是因为Keil最好而是因为网上90%的STM32F103教程都是基于Keil写的你遇到问题搜索的时候能快速找到答案。等你把GPIO、定时器、串口这些基础外设都玩过一遍之后再考虑迁移到VS Code或者CubeIDE。2.2 Keil5安装中那些没人告诉你的细节Keil5的安装本身不复杂但有几个细节如果没注意后面会浪费你大量时间。第一Keil5和Keil C51的共存问题。很多学校课程还在用51单片机你电脑上可能已经装了Keil C51。这两个版本装在同一台电脑上是可以的但必须装在不同的目录下比如C:\Keil_v5和C:\Keil_C51。如果装在同一目录会出现头文件冲突、编译器找不到路径等各种诡异问题。安装顺序也有讲究先装C51再装MDK或者反过来都行关键是目录要分开。第二芯片包的安装。Keil5本身不带STM32的器件支持包Pack你需要单独下载安装。打开Keil后点击Pack Installer图标找到STMicroelectronics下面的STM32F1系列安装对应的DFP包。这个过程需要联网而且服务器在国外下载速度可能很慢。如果实在下不动可以去Keil官网手动下载pack文件然后双击安装。注意芯片包安装完成后在新建工程选择器件时才能看到STM32F103的各个型号。如果你在Device列表里找不到STM32F10399%是芯片包没装好。第三License问题。Keil MDK是收费软件未注册版本有32KB代码限制。对于学习阶段来说32KB其实够用很久了——一个点灯加串口的工程编译出来也就几KB。但如果你后面要跑RTOS或者USB协议栈可能就会超。这个问题自行斟酌我不展开。2.3 VS Code配置STM32开发环境的正确姿势如果你已经有一定基础想用VS Code来开发STM32这条路是可行的但需要装一堆东西。核心组件包括ARM GCC工具链、OpenOCD用于烧录和调试、Cortex-Debug插件、STM32 VS Code Extension可选。配置过程中最容易出问题的是launch.json和tasks.json这两个文件。tasks.json负责定义编译任务launch.json负责定义调试配置。很多人编译成功了但烧录不进去或者调试器连不上基本都是这两个文件的配置有问题。一个典型的launch.json调试配置大概长这样{ version: 0.2.0, configurations: [ { name: STM32 Debug, type: cortex-debug, request: launch, servertype: openocd, cwd: ${workspaceRoot}, executable: ./build/your_project.elf, device: STM32F103C8, configFiles: [ interface/stlink.cfg, target/stm32f1x.cfg ] } ] }关键点在于executable路径要指向你实际编译出来的elf文件configFiles要选对调试器和目标芯片的配置文件。如果你用的是JLink而不是ST-Linkservertype和configFiles都要相应调整。实操心得VS Code方案最大的坑在于工具链版本兼容性。ARM GCC的版本、OpenOCD的版本、Cortex-Debug插件的版本三者之间有时候会打架。我的建议是锁定一套已知可用的版本组合不要盲目追新。比如GCC 10.3 OpenOCD 0.11.0 Cortex-Debug 1.12.0这个组合我实测很稳。3. 从零创建第一个STM32工程标准库还是HAL库3.1 两种库的选型逻辑STM32F103的开发方式主要有两种标准外设库Standard Peripheral Library和HAL库。标准库是ST早期推出的代码简洁直观寄存器操作封装得比较薄适合理解底层原理。HAL库是后来推出的跨系列抽象层代码可移植性好配合CubeMX可以快速生成初始化代码。对于F103这颗芯片我的建议是先学标准库再了解HAL库。原因很简单F103的标准库资料最丰富代码结构清晰你能清楚地看到每个外设的寄存器是怎么配置的。而HAL库为了兼容所有STM32系列加了很多层抽象初学者容易迷失在回调函数和句柄结构体里。当然如果你时间紧、目标是快速做出东西直接上CubeMX HAL库也完全没问题。工具是为人服务的没有绝对的对错。3.2 标准库工程模板的搭建步骤创建一个标准库工程核心是把以下几个东西组织好启动文件根据芯片容量选择F103C8T6是64KB Flash用startup_stm32f10x_md.sF103ZET6是512KB用startup_stm32f10x_hd.s。选错了会导致中断向量表不对程序跑飞。库文件把STM32F10x_StdPeriph_Driver目录下的src和inc文件夹复制到工程目录。用户代码main.c、stm32f10x_it.c中断服务函数、stm32f10x_conf.h库配置头文件。头文件路径在Keil的C/C选项卡里添加所有include路径漏一个就会报找不到头文件的错误。宏定义添加USE_STDPERIPH_DRIVER和STM32F10X_MD根据芯片容量选择MD/HD/XL。这五步做完点击编译如果零错误零警告恭喜你工程模板搭好了。把这个模板保存好以后每个新项目都从这个模板复制能省下大量重复劳动。常见坑很多人编译时报错cannot open source input file stm32f10x.h99%是头文件路径没加对。检查一下Options for Target → C/C → Include Paths里是否包含了所有必要的目录。3.3 用寄存器方式点灯理解GPIO的本质库函数用多了容易变成调包侠我建议每个学STM32的人都至少用寄存器方式点一次灯。不是为了炫技而是为了理解GPIO到底是怎么工作的。以PA5接LED为例寄存器操作分三步// 1. 使能GPIOA时钟 RCC-APB2ENR | (1 2); // 2. 配置PA5为推挽输出50MHz GPIOA-CRL ~(0xF 20); // 清除PA5的配置位 GPIOA-CRL | (0x3 20); // 输出模式50MHz推挽 // 3. 输出低电平点亮LED GPIOA-ODR ~(1 5);这三行代码背后涉及的知识点包括RCC时钟树、APB2总线、GPIO端口配置寄存器CRL/CRH、输出数据寄存器ODR。把这几行搞明白了再看库函数GPIO_Init()里面做了什么就会豁然开朗。4. 核心外设实操GPIO、定时器、串口、中断4.1 GPIO输入输出按键与LED的经典组合GPIO是STM32最基础也最常用的外设。输出模式点灯输入模式读按键这两个操作覆盖了大部分入门实验。按键输入有一个必须处理的问题机械抖动。按键按下和松开的瞬间电平会快速跳变多次如果不做处理一次按下可能被识别成多次。解决方法有两种硬件加RC滤波电路或者软件延时消抖。软件消抖的典型代码if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) 0) { Delay_ms(20); // 延时20ms等待抖动结束 if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) 0) { // 确认按键按下执行操作 LED_Toggle(); while (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) 0); // 等待松开 } }20ms这个值不是随便定的。机械按键的抖动时间通常在5-10ms之间取20ms留足余量。延时太短消抖不彻底太长则按键响应迟钝。注意事项按键电路设计时如果用的是下拉电阻方案按键接VCC另一端通过电阻接地那么按键按下时读到的是高电平。如果用的是上拉方案按键接地另一端通过电阻接VCC按下时读到的是低电平。两种方案逻辑相反写代码时别搞混了。4.2 定时器STM32最强大的外设之一STM32F103的定时器资源非常丰富有高级定时器TIM1/TIM8、通用定时器TIM2-TIM5、基本定时器TIM6/TIM7。每种定时器的功能不同但最常用的功能是定时中断和PWM输出。定时中断的配置逻辑是这样的系统时钟72MHz经过预分频器PSC分频后得到计数器时钟计数器从0计到自动重装载值ARR时产生溢出中断。定时周期的计算公式定时周期 (PSC 1) × (ARR 1) / 72,000,000 秒比如要定时1ms可以设PSC71ARR999那么(711)×(9991)/72,000,000 72×1000/72,000,000 0.001秒 1ms。PWM输出的配置类似只是多了输出比较模式的选择。控制LED亮度、驱动舵机、调节电机转速都离不开PWM。以驱动SG90舵机为例需要50Hz的PWM信号周期20ms脉宽0.5ms对应0度2.5ms对应180度。配置时PSC71ARR19999就能得到50Hz的PWM。输入捕获是定时器的另一个重要功能可以用来测量外部信号的频率和脉宽。比如配合超声波模块HC-SR04测距就是通过捕获回波信号的高电平持续时间来计算距离的。距离 高电平时间 × 声速 / 2。4.3 串口通信调试和通信的万能工具串口是STM32开发中最重要的调试手段。printf重定向到串口可以让你像在PC上一样打印调试信息比点灯调试高效一百倍。串口配置的核心参数波特率、数据位、停止位、校验位。最常用的是115200-8-N-1波特率1152008位数据无校验1位停止位。配置步骤包括使能USART和GPIO时钟、配置TX为复用推挽输出、RX为浮空输入、设置USART参数、使能USART。printf重定向需要实现fputc函数int fputc(int ch, FILE *f) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, (uint8_t)ch); return ch; }然后在Keil的Target选项中勾选Use MicroLIB。这样就能直接用printf(Hello STM32\r\n)输出调试信息了。实操心得串口接收数据时如果用的是中断方式记得在中断服务函数里清除接收标志位。忘了清除会导致中断反复触发程序卡死在中断里。另外接收不定长数据时推荐用空闲中断 DMA的方案效率比逐字节中断高得多。4.4 中断系统NVIC的配置要点STM32的中断由NVIC嵌套向量中断控制器管理。配置一个外部中断的完整流程使能GPIO和AFIO时钟、配置GPIO为输入、配置AFIO的EXTI线映射、配置EXTI触发方式、配置NVIC优先级、使能EXTI中断。NVIC优先级分为抢占优先级和响应优先级。抢占优先级高的中断可以打断正在执行的抢占优先级低的中断响应优先级只在同时触发时决定谁先执行。对于F103来说优先级分组通常设为NVIC_PriorityGroup_2即2位抢占优先级、2位响应优先级。常见坑中断服务函数的名称必须和启动文件里定义的一致。比如EXTI0的中断函数名是EXTI0_IRQHandler写成EXTI0_Handler就不会被调用。这个错误很隐蔽编译不会报错但中断就是不响应。5. 烧录与调试那些让人抓狂的问题5.1 ST-Link、JLink、串口下载怎么选STM32F103支持多种下载方式ST-LinkSWD接口、JLinkSWD/JTAG接口、串口ISP下载。三种方式各有适用场景。ST-Link是最常用的便宜山寨版十几块钱、支持调试、Keil和VS Code都能用。JLink更专业支持更多芯片型号但正版价格高山寨版稳定性参差不齐。串口下载不需要额外调试器但只能下载不能调试而且需要手动切换BOOT引脚。对于初学者我建议直接买一个ST-Link V2。接线也简单SWDIO接PA13SWCLK接PA14GND接GND3.3V接3.3V。四根线搞定。5.2 烧录失败的排查流程烧录失败是新手遇到最多的问题。我整理了一个排查表按顺序检查现象可能原因解决方法找不到设备接线错误或调试器驱动未装检查SWDIO/SWCLK接线重装驱动能识别但烧录报错Flash被读保护用ST-Link Utility解除读保护烧录成功但不运行BOOT引脚状态不对BOOT0接GNDBOOT1任意提示Flash Download failed芯片型号选错检查Keil中Device选择调试器连接不稳定SWD线太长或干扰缩短接线降低SWD速度其中Flash被读保护这个问题特别常见。如果你之前烧过程序设置了读保护或者芯片是二手拆机的很可能处于保护状态。用ST-Link Utility连接后在Target菜单里选择Option Bytes把读保护级别改为Level 0即可。踩过的坑有一次帮朋友调板子烧录一直失败换了三根线、两个调试器都不行。最后发现是板子上的BOOT0跳线帽接触不良导致芯片一直处于系统存储器启动模式。所以排查问题时先检查硬件连接再怀疑软件配置这个顺序能帮你省下大量时间。5.3 调试技巧断点、watch窗口和串口打印Keil的调试功能很强大但很多人只会按F5全速运行。其实断点、单步执行、Watch窗口观察变量、Memory窗口查看内存这些功能组合起来用定位问题的效率比串口打印高得多。不过串口打印也有不可替代的优势它不影响程序运行时序能看到程序实际运行时的数据流。我的习惯是逻辑错误用断点调试时序问题用串口打印硬件问题用示波器。6. 进阶方向选择从点灯到做项目6.1 根据目标选择学习路径把基础外设玩明白之后下一步往哪走取决于你的目标。我大致分几个方向找工作/做产品深入学习FreeRTOS、CAN通信、Modbus协议、USB设备开发。这些是工控和消费电子领域最常用的技术。参加竞赛/做毕业设计根据题目需求选外设比如超声波测距、OLED显示、DS3231时钟、步进电机控制。重点是快速出成果。个人兴趣/折腾可以玩FOC电机控制、音频处理、自定义USB设备等。6.2 几个值得动手的练手项目超声波测距 OLED显示用HC-SR04测距结果实时显示在OLED上。涉及定时器输入捕获、I2C通信、OLED驱动是一个很好的综合练习。DS3231高精度时钟DS3231是I2C接口的实时时钟芯片精度比STM32内部RTC高得多。配合OLED做一个桌面时钟涉及I2C、中断、时间处理。CAN总线通信CAN在汽车电子和工控领域应用广泛。用两块STM32F103通过CAN收发器如TJA1050通信学习CAN协议和过滤器配置。USB HID设备把STM32F103做成一个自定义HID设备比如模拟键盘或游戏手柄。涉及USB协议栈、描述符配置、端点通信。这个难度较高建议有一定基础后再尝试。6.3 关于STM32过时了这个说法经常看到有人说STM32F103太老了现在应该学ESP32、学瑞萨、学国产替代。我的看法是F103确实老但它的学习价值没有过时。Cortex-M3的架构、外设的工作原理、中断系统的设计思路这些东西在 newer 芯片上是一样的。你把F103学透了换任何一款ARM Cortex-M芯片都能快速上手。而且F103的生态太成熟了你遇到的任何问题网上几乎都有现成的答案。对于初学者来说这个遇到问题能搜到答案的体验非常重要它能让你保持学习的正反馈。7. 我个人的一些经验体会带过不少新手之后我发现学STM32最大的障碍不是技术难度而是信息过载带来的选择困难。网上教程太多了有人说用标准库有人说用HAL库有人说Keil好有人说VS Code香。新手在这些选择之间反复横跳时间全花在折腾环境上了。我的建议很简单随便选一条路先走通一遍。用Keil 标准库把GPIO、定时器、串口、中断这四个外设各做一个实验你就已经超过80%的初学者了。等你有了这个基础再去尝试其他工具和库那时候你已经有能力判断哪个更适合自己了。另外买板子的时候不要贪多。一块F103C8T6最小系统板加一个ST-Link总共不到五十块钱足够你学完所有基础外设。等真正需要特定外设比如CAN、USB、以太网的时候再按需购买对应的模块或开发板。我见过太多人买了一堆板子最后都在吃灰。最后分享一个我常用的调试技巧当程序跑飞或者行为异常时先检查时钟配置。STM32的很多外设行为都依赖正确的时钟使能和分频设置。RCC配置错了后面所有外设都会出问题。用Keil的System Viewer可以直观地查看各个寄存器的当前值比盲猜高效得多。