STM32F103开发板入门实战：从硬件认知到外设驱动全解析

1. 拿到板子先别急着点灯：STM32F103开发板入门全景拆解

STM32F103开发板到手的那一刻，很多人第一反应是插上USB线，打开Keil，找个点灯例程烧进去看看。这个冲动我完全理解，但如果你真想把这块板子学透，而不是停留在“烧个例程发朋友圈”的阶段，那开局的路子就得走对。STM32F103这颗芯片，江湖人称“单片机界的五菱宏光”——性能够用、资料管够、价格便宜、到处都是它的身影。从智能小车到工业控制，从毕业设计到量产项目，你几乎能在任何嵌入式场景里看到它的存在。但正因为资料太多、教程太杂，新手反而容易迷失：标准库还是HAL库？Keil还是VS Code？ST-Link还是串口下载？这些问题不搞清楚，后面每一步都是坑。

这篇文章面向的是刚拿到STM32F103开发板、准备系统学习的朋友，也适合那些之前零散玩过几次、但始终没建立起完整知识框架的人。我会从硬件认识、工具链搭建、工程模板建立、外设驱动开发、调试排错这几个维度，把STM32F103入门的完整路径拆开讲清楚。不是照着手册念，而是把我自己踩过的坑、总结的技巧、以及那些“当时要是有人告诉我就好了”的经验，全部摊开来聊。看完之后，你至少能做到：拿到任意一块F103板子，知道怎么下手，知道每一步为什么这么做，出了问题知道往哪个方向排查。

2. 硬件认知与开发环境搭建

2.1 开发板上的东西都是什么

一块典型的STM32F103开发板，板载资源通常包括：核心芯片（常见型号F103C8T6、F103ZET6、F103RCT6等）、晶振电路（8MHz外部高速晶振+32.768kHz低速晶振）、复位电路、电源电路（USB供电或DC接口）、LED指示灯、按键、以及各种外设接口（USART、SPI、I2C、CAN、USB等）。不同价位的板子扩展资源差别很大，但核心部分大同小异。

拿到板子后，先做三件事：第一，确认芯片具体型号，这决定了Flash大小、RAM大小、外设数量，直接影响你后续能跑多大的程序。第二，找到BOOT0和BOOT1跳线帽的位置，这关系到芯片从哪个存储区启动。第三，确认板子上的下载接口类型——是JTAG/SWD排针，还是板载了ST-Link芯片，还是只有串口下载。这三个信息决定了你接下来的工具选型和操作方式。

注意：很多便宜板子上的USB接口只负责供电，不具备下载功能。别看到USB口就以为插上线就能烧程序，先确认板子上有没有CH340之类的USB转串口芯片，或者有没有板载调试器。

2.2 工具链选择：Keil、VS Code还是其他

工具链的选择是新手第一个纠结的点。我的建议很直接：入门阶段用Keil MDK，不要一上来就折腾VS Code加各种插件。原因很简单——Keil的STM32支持最成熟，芯片包安装方便，调试器配置直观，出了问题网上能搜到的解决方案最多。等你对STM32的工程结构、编译流程、调试机制都熟悉了，再去折腾VS Code加EIDE或者PlatformIO，那时候你已经有判断力了。

Keil MDK的安装流程大致是：下载安装包、安装主程序、安装芯片包（Pack）、配置License。芯片包安装这一步经常有人卡住，因为Keil的Pack Installer在国内网络环境下下载速度可能很慢。一个实用的办法是直接去Keil官网或者意法半导体官网下载对应的Pack文件，离线安装。F103系列对应的Pack是Keil.STM32F1xx_DFP，下载下来双击安装就行。

如果你确实想用VS Code，那需要额外安装ARM GCC工具链、OpenOCD或PyOCD作为调试后端、以及Cortex-Debug插件。这套组合灵活性更高，但配置复杂度也上去了。我见过太多新手在VS Code里编译成功却烧录不进去的情况，最后发现是OpenOCD的配置文件写错了，或者调试器驱动没装对。所以我的建议是：先用Keil把STM32跑通，再考虑迁移。

2.3 ST-Link驱动与烧录工具

ST-Link是ST官方推出的调试器，价格便宜（山寨版十几块钱），支持SWD接口，能下载能调试，是STM32开发的首选工具。使用ST-Link需要安装驱动，Windows下通常会自动识别，如果识别不了就去ST官网下载ST-Link驱动手动安装。

烧录工具方面，ST官方提供了STM32 ST-LINK Utility和STM32CubeProgrammer两个工具。前者是老牌工具，界面简洁，功能够用；后者是新一代工具，支持更多芯片系列和功能。两个都装上不冲突，日常用哪个顺手就用哪个。另外，Keil本身也集成了ST-Link的下载和调试功能，配置好之后可以直接在Keil里一键下载。

实操心得：ST-Link的SWD接口只需要四根线——VCC、GND、SWDIO、SWCLK。接线时务必确认开发板的SWD接口引脚顺序，接反了不会烧板子，但会连不上。如果连不上，先检查接线，再检查开发板是否供电，最后检查ST-Link驱动是否正常。

3. 工程模板建立与标准库工程结构

3.1 为什么需要一个自己的工程模板

很多新手每次新建工程都是从零开始，把启动文件、库文件、头文件路径一个个加进去，费时费力还容易出错。正确的做法是：建立一个通用的工程模板，包含所有常用的库文件、启动文件、中断向量表、以及基本的系统初始化代码。之后每做一个新项目，直接复制这个模板，改个名字就能用。

一个标准的STM32F103标准库工程模板，目录结构通常是这样组织的：

Project/ ├── CMSIS/ # 内核支持文件 │ ├── core_cm3.h │ ├── core_cm3.c │ └── system_stm32f10x.c/h ├── Library/ # 标准外设库 │ ├── inc/ # 库头文件 │ └── src/ # 库源文件 ├── Startup/ # 启动文件 │ └── startup_stm32f10x_md.s ├── User/ # 用户代码 │ ├── main.c │ ├── stm32f10x_conf.h │ ├── stm32f10x_it.c/h │ └── system_stm32f10x.c ├── HardWare/ # 硬件驱动 │ ├── led.c/h │ ├── key.c/h │ └── usart.c/h └── Output/ # 编译输出

这个结构的好处是清晰：CMSIS和Library是官方提供的，不用动；Startup是启动文件，根据芯片容量选择对应的版本；User放主程序和中断服务函数；HardWare放自己写的外设驱动。编译输出单独放一个目录，方便清理。

3.2 启动文件的选择与中断向量表

启动文件是很多人忽略但非常关键的一环。STM32F103根据Flash容量分为小容量（16-32KB）、中容量（64-128KB）、大容量（256-512KB）三种，对应的启动文件分别是startup_stm32f10x_ld.s、startup_stm32f10x_md.s、startup_stm32f10x_hd.s。选错了启动文件，程序可能编译通过但运行异常，或者根本进不了main函数。

启动文件里定义了中断向量表，这是STM32中断机制的基石。每个中断入口地址在向量表中占一个位置，CPU收到中断后根据向量表跳转到对应的服务函数。标准库的中断服务函数名字是固定的，比如USART1_IRQHandler、TIM2_IRQHandler，你需要在stm32f10x_it.c里实现这些函数。如果函数名写错了，中断触发时就会跳转到默认的死循环里，程序看起来就像“卡死”了。

注意：启动文件里的堆栈大小是可以调整的。默认的栈大小通常够用，但如果你用了比较大的局部数组或者递归调用，可能需要增大栈空间。在启动文件开头找到Stack_Size和Heap_Size的定义，根据实际需要修改。

3.3 系统时钟配置：72MHz是怎么来的

STM32F103的最高主频是72MHz，这个频率不是凭空来的，而是通过外部晶振倍频得到的。典型配置是：外部8MHz晶振（HSE）经过PLL倍频9倍，得到72MHz作为系统时钟（SYSCLK）。然后AHB预分频器不分频，APB1预分频器除以2得到36MHz（APB1最高36MHz），APB2预分频器不分频得到72MHz。

标准库里的SystemInit函数会自动完成这套配置，你不需要手动去写寄存器。但理解这个过程很重要，因为后面配置定时器、串口波特率、SPI速率时，都需要知道当前的总线时钟频率。比如你要配置USART1的波特率为115200，就需要知道USART1挂在APB2上，时钟是72MHz，然后根据波特率计算公式算出分频值。

如果你用的是HAL库，时钟配置通常在CubeMX里图形化完成，生成代码时会自动生成SystemClock_Config函数。标准库则是在system_stm32f10x.c里预定义了几种时钟配置，通过宏定义选择。默认的SYSCLK_FREQ_72MHz就是最常用的配置。

4. 外设驱动开发实战

4.1 GPIO点灯：从寄存器到库函数

点灯是嵌入式的“Hello World”，但即使是这么简单的操作，也有几种不同的实现方式。最底层的是直接操作寄存器：

// 使能GPIOB时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPBEN; // 配置PB0为推挽输出，最大速度50MHz GPIOB->CRL &= ~(0x0F << 0); GPIOB->CRL |= (0x03 << 0); // 输出低电平 GPIOB->BRR = GPIO_Pin_0;

标准库把这套操作封装成了函数：

RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); GPIO_ResetBits(GPIOB, GPIO_Pin_0);

两种方式本质上是一样的，库函数只是把寄存器操作包装了一层。初学阶段建议两种都了解一下，知道库函数底层做了什么，后面调试的时候心里有底。

实操心得：点灯不亮的时候，排查顺序是——先确认时钟使能了没有（RCC_APB2PeriphClockCmd），再确认GPIO模式配置对不对（输出模式还是输入模式），然后确认引脚号有没有写错，最后用万用表量一下引脚电压。我见过有人把GPIO_Pin_0写成GPIO_Pin_1，找了半天问题。

4.2 串口通信：USART配置与printf重定向

串口是调试利器，也是STM32最常用的通信接口之一。配置USART1的基本步骤是：使能USART1和GPIOA时钟、配置PA9为复用推挽输出（TX）、PA10为浮空输入（RX）、配置USART参数（波特率、数据位、停止位、校验位）、使能USART、如果需要中断则配置NVIC。

RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); USART_InitTypeDef USART_InitStructure; USART_InitStructure.USART_BaudRate = 115200; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &USART_InitStructure); USART_Cmd(USART1, ENABLE);

printf重定向是串口调试的标配，通过重写fputc函数，让printf输出到串口：

int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t)ch); while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); return ch; }

注意，使用printf需要包含stdio.h头文件，并且在Keil的Target选项中勾选“Use MicroLIB”。不勾选的话，标准库的printf会依赖半主机模式，导致程序卡在启动阶段。

4.3 定时器：从延时到PWM

STM32F103的定时器资源很丰富，有高级定时器TIM1/TIM8、通用定时器TIM2-TIM5、基本定时器TIM6/TIM7。定时器最基础的用途是定时中断，比如每1ms进一次中断，在中断里做计数或者任务调度。

配置定时器中断的步骤：使能定时器时钟、配置时基结构体（预分频值、自动重装载值、计数模式、时钟分频）、配置中断优先级、使能定时器中断、使能定时器。

RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_TimeBaseStructure.TIM_Period = 999; // 自动重装载值 TIM_TimeBaseStructure.TIM_Prescaler = 71; // 预分频值 TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, &TIM_TimeBaseStructure); TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE); TIM_Cmd(TIM2, ENABLE);

这里定时时间的计算是：定时周期 = (Prescaler + 1) × (Period + 1) / 时钟频率。TIM2挂在APB1上，时钟是72MHz（APB1预分频器为2时，定时器时钟会倍频）。所以(71+1)×(999+1)/72000000 = 1ms。

PWM输出是定时器的另一个重要应用。配置PWM需要设置PWM模式、占空比、输出极性，然后使能通道。PWM频率由定时器时基决定，占空比由比较寄存器决定。用PWM控制LED亮度、电机速度、舵机角度，都是常见场景。

4.4 中断系统与NVIC配置

STM32的中断系统由NVIC（嵌套向量中断控制器）管理，支持中断优先级分组、抢占优先级和响应优先级。F103的中断优先级分组有5种，通过NVIC_PriorityGroupConfig设置。常用的分组是NVIC_PriorityGroup_2，即2位抢占优先级、2位响应优先级。

NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); NVIC_InitTypeDef NVIC_InitStructure; NVIC_InitStructure.NVIC_IRQChannel = TIM2_IRQHandler; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1; NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure);

抢占优先级高的中断可以打断抢占优先级低的中断，响应优先级只在同时触发时决定谁先执行。理解这两者的区别，对后面做多任务调度和实时响应很关键。

常见问题：中断进了但只执行一次，或者程序卡在中断里出不来。前者通常是忘记清除中断标志位，后者可能是中断服务函数里写了死循环或者阻塞操作。中断服务函数应该尽量短小，耗时操作放到主循环里做。

5. 调试排错与常见问题实录

5.1 编译通过但烧录失败

这是新手遇到最多的问题之一。编译成功说明代码语法没问题，但烧录失败的原因可能有很多：ST-Link连接不稳定、芯片被写保护、BOOT引脚状态不对、Flash算法选择错误、芯片型号选错等。

排查步骤：先确认ST-Link和开发板的SWD线连接正确（SWDIO、SWCLK、GND、VCC四根线），然后用STM32CubeProgrammer连接一下，看能不能识别到芯片。如果识别不到，检查驱动和接线；如果能识别但烧录报错，检查Flash是否被写保护，可以通过CubeProgrammer解除保护。如果提示“Flash Download failed”，检查Keil的Debug设置里Flash算法是否选对了型号。

实操心得：有时候ST-Link能识别芯片但烧录总是失败，换一根USB线就好了。劣质USB线供电不足或者数据线阻抗太大，会导致SWD通信不稳定。这个坑我踩过不止一次。

5.2 程序跑不起来：从BOOT引脚查起

程序烧录成功但运行不正常，先检查BOOT0和BOOT1引脚。BOOT0=0时从主Flash启动，这是正常运行模式；BOOT0=1时从系统存储器启动，用于串口下载。如果BOOT0被误设为1，程序烧进去了也不会运行。

另一个常见原因是时钟配置错误。如果外部晶振没起振，而程序又配置了HSE作为时钟源，系统会卡在时钟初始化里。可以用示波器量一下晶振引脚有没有波形，或者临时改用HSI内部时钟测试。

5.3 串口乱码与波特率计算

串口输出乱码，九成是波特率不对。波特率的计算公式是：USARTDIV = 时钟频率 / (16 × 波特率)。比如USART1时钟72MHz，波特率115200，则USARTDIV = 72000000 / (16 × 115200) = 39.0625。标准库的USART_Init函数会自动计算这个值，但前提是你传入的时钟频率和实际一致。

如果时钟配置改了但串口初始化没跟着改，就会出现乱码。另外，如果用了外部晶振但实际晶振频率不是8MHz（比如用了12MHz），系统时钟就不是72MHz，串口波特率也会偏。所以晶振频率和时钟配置必须匹配。

5.4 常见问题速查表

6. 进阶方向与学习路径建议

6.1 从标准库到HAL库的过渡

标准库适合理解底层原理，HAL库适合快速开发。当你对标准库的外设配置流程熟悉之后，可以尝试用STM32CubeMX生成HAL库工程。CubeMX的图形化配置能大幅减少初始化代码的编写时间，而且HAL库的跨系列兼容性更好，以后换到F4、F7、H7系列时迁移成本更低。

但不要一上来就用CubeMX，那样你会错过很多底层细节。我建议的学习路径是：先用标准库把GPIO、USART、TIM、NVIC、SPI、I2C这些外设都手动配置一遍，理解每个寄存器的含义和配置流程，然后再用CubeMX加HAL库提高效率。

6.2 值得练手的几个小项目

学STM32最怕只看不练。以下几个项目难度递进，适合作为练手目标：

• 按键控制LED：练GPIO输入输出和消抖逻辑
• 串口命令行：练USART收发和字符串解析
• 定时器PWM调光：练定时器PWM输出和占空比调节
• 超声波测距：练定时器输入捕获和中断处理
• OLED显示：练I2C通信和字库取模
• SD卡读写：练SPI通信和文件系统
• FreeRTOS多任务：练RTOS任务调度和信号量

每个项目不需要做得多复杂，关键是走完“需求分析→硬件连接→驱动编写→调试排错”的完整流程。做上三五个之后，你对STM32的理解会完全不一样。

6.3 调试工具与技巧的进阶

除了ST-Link，还有一些工具值得了解。逻辑分析仪可以抓取SPI、I2C、USART的时序波形，排查通信问题时非常有用。示波器可以看PWM波形、晶振起振情况、电源纹波。J-Link是更专业的调试器，支持RTT实时日志输出，调试体验比ST-Link好很多，但价格也贵不少。

软件方面，STM32CubeMonitor可以实时监控变量变化，FreeRTOS的Tracealyzer可以可视化任务调度情况。这些工具在复杂项目里能大幅提升调试效率。

最后分享一个小技巧：在Keil里调试时，善用Watch窗口和Memory窗口。Watch窗口可以实时查看变量值，Memory窗口可以查看任意地址的内存数据。配合断点和单步执行，大部分逻辑错误都能快速定位。另外，在代码里加一些调试打印，比单纯靠断点调试效率高得多，尤其是在中断频繁触发的场景下。