简介：本资源是一套面向STM32嵌入式开发初学者与进阶工程师的完整例程合集，聚焦STM32F103RCT6（ARM Cortex-M3内核）硬件平台，覆盖GPIO、UART、SPI、ADC、PWM、定时器、外部中断等核心外设的HAL库实战代码，适用于智能硬件原型开发、课程设计及毕业项目快速启动。压缩包共3444个文件，主体为824个C源码与866个头文件（实现功能逻辑与接口定义），辅以455个目标文件、434个依赖信息及21个Keil工程文件（uvproj/uvprojx），含UCOSII、LCD、USB读卡器、温度传感等典型应用工程，整体达123.09MB，结构规范、模块清晰，便于按外设或项目分层学习。已有1100人下载学习，配套例程均经实际编译验证，包含AXF/HEX可执行镜像与调试配置文件，可直接导入Keil uVision或STM32CubeIDE运行调试，显著降低环境搭建门槛与排错成本。

1. STM32F103RCT6例程：不是抄代码，而是搭一条能跑通、能改、能答辩的嵌入式最小闭环

你手头有一块STM32F103RCT6核心板，J-Link也接上了，Keil里点“Download”却卡在“Connecting to target…”；或者好不容易点亮了LED，但想加个串口打印就崩在USART_Init()里；又或者毕设答辩前夜，发现定时器中断和ADC采样一并启用时数据全乱——这些不是玄学，是典型“例程没吃透”的后遗症。这套STM32F103RCT6例程，专为解决“从例程到项目”的断层而设计：它不堆砌50个功能模块，而是用6个强耦合、可验证的最小闭环（LED+按键+串口+定时器+ADC+I2C），覆盖启动流程、外设时钟使能顺序、中断优先级分组、寄存器操作与标准外设库混用等真实踩坑点。适合正在做课程设计、毕业设计，或刚转嵌入式需要快速建立硬件-固件联调直觉的开发者。它不是教科书，而是一份带注释的“调试日志”，每行代码背后都标着“为什么这里必须先开RCC，为什么SysTick要配成999而不是1000”。

2. 硬件平台与开发环境：明确边界才能避免“我的板子和例程对不上”

2.1 核心硬件规格：以STM32F103RCT6为锚点，拒绝模糊描述

本例程严格绑定芯片型号STM32F103RCT6（非C8T6、非ZET6），其关键参数直接决定例程能否移植：

• 封装：LQFP64（64引脚），非48引脚版本，因此PA15/JTDI、PB3/JTDO等调试引脚默认复用为SWD，不支持JTAG模式；
• Flash容量：256KB（注意：部分例程若含大数组或未优化printf，可能超限）；
• SRAM：48KB（足够运行本套例程，但若后续加FreeRTOS需预留至少8KB）；
• 主频：最高72MHz，系统时钟源必须为HSE（外部8MHz晶振），而非HSI（内部8MHz RC），因例程中所有外设时钟分频均按HSE=8MHz计算（如APB2=72MHz需PLL倍频9倍）。

提示：若你的板子焊接的是6MHz或12MHz晶振，必须修改system_stm32f10x.c中HSE_VALUE宏定义，并重新计算PLL配置值，否则所有定时器、串口波特率将严重偏差。

2.2 开发工具链：Keil MDK-ARM v5.37（非v5.26或v5.38）

本例程工程文件（.uvprojx）基于Keil MDK-ARM v5.37构建，原因如下：

• v5.26及更早版本不支持CMSIS 4.5以上标准，导致core_cm3.h中__NVIC_PRIO_BITS定义异常，引发中断优先级配置失效；
• v5.38引入ARM Compiler 6（AC6），而本例程使用ARM Compiler 5（AC5），因AC6对__packed结构体对齐处理更严格，易导致I2C通信中uint8_t数组地址错位；
• 工程中已预置STMicroelectronics STM32F1xx_DFP 2.3.0设备支持包，禁止升级至2.4.0+，因其修改了stm32f10x.h中RCC_CFGR_PLLMUL位域定义，导致RCC_PLLConfig(RCC_PLLSource_HSE_Div2, RCC_PLLMul_9)编译报错。

// system_stm32f10x.c 中关键时钟配置（HSE=8MHz） RCC_DeInit(); // 复位RCC寄存器 RCC_HSEConfig(RCC_HSE_ON); // 启用外部晶振 while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET); // 等待晶振稳定 RCC_PLLConfig(RCC_PLLSource_HSE_Div2, RCC_PLLMul_9); // HSE/2=4MHz → PLL×9=36MHz → 经APB1分频得72MHz RCC_PLLCmd(ENABLE); while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET); RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); // 切换系统时钟为PLL

2.3 调试接口：SWD模式下必须关闭JTAG复用功能

STM32F103RCT6的SWDIO（PA13）与SWCLK（PA14）在复位后默认为JTAG模式（JTMS、JTCK），若未显式禁用JTAG，会导致：

• J-Link连接成功但无法下载（提示“Target not halted”）；
• 按键检测失灵（因PB4被JTBN复用占用）。
  解决方案：在main()最开头强制关闭JTAG，仅保留SWD：

#include "stm32f10x_gpio.h" #include "stm32f10x_rcc.h" int main(void) { // 必须在任何GPIO初始化前执行！ RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_AFIO, ENABLE); // 使能AFIO时钟 GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 关闭JTAG，仅保留SWD // 后续初始化LED、按键等... }

2.4 外设引脚映射：以原理图为唯一依据，拒绝“网上教程说PA0就是ADC1_IN0”

本例程所有外设引脚均按标准STM32F103RCT6评估板原理图定义，关键映射如下：

注意：PA0同时承担KEY1和ADC1_IN0，例程中通过GPIO_Init()动态切换GPIO_Mode_IN_FLOATING（按键）与GPIO_Mode_AIN（ADC），不可同时启用，否则ADC采样值恒为0。

3. 总体架构设计：六模块闭环驱动，每个模块自带自检逻辑

3.1 分层架构：硬件抽象层（HAL）与业务逻辑解耦

本例程采用轻量级分层设计，不引入HAL库或LL库，全部基于标准外设库（StdPeriph_Lib_V3.5.0），但通过封装实现职责分离：

• bsp/：板级支持包（Board Support Package），含bsp_led.c、bsp_key.c等，只操作寄存器，不涉及业务；
• driver/：外设驱动层，如drv_usart.c、drv_adc.c，提供Usart_Printf()、Adc_GetValue()等接口；
• app/：应用层，main.c中仅调用驱动接口，如Key_Scan()返回键值后，由app_key_handler()决定是否触发LED翻转或串口发送。

此结构确保：更换不同品牌核心板时，只需重写bsp/目录下文件，app/逻辑完全复用。

3.2 六大核心模块闭环：每个模块可独立验证

例程包含6个强验证性模块，每个模块均实现“输入→处理→输出→反馈”闭环：

3.3 启动流程与中断向量重定向：从Reset_Handler到用户main

例程严格遵循ARM Cortex-M3启动规范，关键点：

• startup_stm32f10x_md.s中Reset_Handler执行后，先调用SystemInit()再跳转main()，确保系统时钟、向量表偏移等初始化完成；
• main()中第一行即调用NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2)，将中断优先级分组设为2位抢占+2位响应（共16级），避免SysTick与EXTI0中断嵌套失败；
• 若使用串口接收中断（USART1_IRQn），其抢占优先级必须低于SysTick_IRQn（SysTick默认为0），否则可能导致SysTick被阻塞，系统滴答失准。

// main.c 中中断优先级配置示例 NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; // 抢占优先级1（低于SysTick的0） NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0; NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure);

3.4 时钟树配置：一张图看懂72MHz如何生成

本例程时钟树配置如下（HSE=8MHz）：

HSE (8MHz) ↓ 分频2 PLLSRC (4MHz) ↓ PLL倍频9 PLLCLK (36MHz) ↓ 经AHB预分频1 → HCLK=36MHz? 错！实际为72MHz！ ↓ 正确路径：PLLCLK经APB1分频2 → PCLK1=36MHz，APB2分频1 → PCLK2=72MHz ↓ USART1挂载APB2，故波特率=72MHz/(16×DIV)

关键纠正：网上常见错误认为“PLLCLK直接作为SYSCLK”，实则STM32F103需通过RCC_SYSCLKConfig()选择PLLCLK为系统时钟源，且APB2总线时钟（PCLK2）等于SYSCLK（72MHz），而APB1（PCLK1）为SYSCLK/2（36MHz）。此细节决定串口、ADC、TIM2等外设速率。

4. 关键模块实现详解：从寄存器配置到抗干扰设计

4.1 LED与按键：看似简单，实为时序敏感的入门关

LED控制陷阱：PC13驱动能力弱，直接驱动LED易受干扰。例程采用推挽输出+1kΩ限流电阻+0.1μF去耦电容：

void LED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOC, ENABLE); // 使能PORTC时钟 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); // 默认高电平，LED灭（因共阳？不！本板为共阴，低电平亮） }

注意：PC13在多数开发板上为“低电平点亮”，因LED阳极接VCC，阴极经限流电阻接PC13。若接反，LED永不亮。

按键消抖血泪经验：独立按键PA0下拉输入，硬件消抖仅靠100nF电容不够，必须软件二次确认：

#define KEY_SCAN_INTERVAL 20 // 20ms扫描一次 uint8_t Key_Scan(void) { static uint8_t key_state = 0; static uint16_t cnt = 0; if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == Bit_RESET) { // 按下 if (++cnt > 20) { // 持续20次扫描（400ms）才确认 key_state = KEY_PRES; cnt = 0; } } else { if (key_state == KEY_PRES) { key_state = KEY_REL; // 释放事件 } cnt = 0; } return key_state; }

为什么不用延时消抖？因SysTick中断每1ms触发，若在Key_Scan()中调用Delay_ms(20)，会阻塞整个系统，导致串口接收丢失。

4.2 串口通信：环形缓冲区与printf重定向的实战配置

USART1初始化要点：

• 波特率9600：USART_InitStruct.USART_BaudRate = 9600；
• 字长8位：USART_InitStruct.USART_WordLength = USART_WordLength_8b；
• 无校验：USART_InitStruct.USART_Parity = USART_Parity_No；
• 1停止位：USART_InitStruct.USART_StopBits = USART_StopBits_1；
• 硬件流控关闭：USART_InitStruct.USART_HardwareFlowControl = USART_HardwareFlowControl_None。

环形缓冲区防丢包：接收中断中仅存入缓冲区，主循环中解析：

#define RX_BUFFER_SIZE 64 uint8_t rx_buffer[RX_BUFFER_SIZE]; volatile uint16_t rx_head = 0, rx_tail = 0; void USART1_IRQHandler(void) { USART_TypeDef* USARTx = USART1; uint8_t res; if(USART_GetITStatus(USARTx, USART_IT_RXNE) != RESET) { res = USART_ReceiveData(USARTx); rx_buffer[rx_head] = res; rx_head = (rx_head + 1) % RX_BUFFER_SIZE; // 环形指针 } } // 主循环中解析 if (rx_head != rx_tail) { uint8_t data = rx_buffer[rx_tail]; rx_tail = (rx_tail + 1) % RX_BUFFER_SIZE; // 处理data... }

printf重定向到串口：

// 重定义fputc，使printf可用 int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t) ch); while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET); return ch; }

注意：while(USART_GetFlagStatus(...))必须检查TC（Transmission Complete）标志，而非TXE（Transmit Data Register Empty），否则最后一字节可能未发出即返回。

4.3 ADC采样：单通道连续转换与电压校准

ADC1_IN0（PA0）配置关键：

• 先将PA0配置为模拟输入：GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AIN；
• 使能ADC1时钟：RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_ADC1, ENABLE)；
• 设置ADC时钟预分频：RCC_ADCCLKConfig(RCC_PCLK2_Div6)（72MHz/6=12MHz，符合ADC最大14MHz要求）；
• 单通道规则转换：ADC_RegularChannelConfig(ADC1, ADC_Channel_0, 1, ADC_SampleTime_55_5Cycles)。

电压校准避坑：STM32F103内置温度传感器与Vrefint，但例程中不启用校准，因校准值存储于Option Bytes，量产芯片可能被锁死。改为软件校准：

// 采集10次取平均，消除噪声 uint16_t Adc_GetValue(void) { uint32_t sum = 0; for(uint8_t i=0; i<10; i++) { ADC_SoftwareStartConvCmd(ADC1, ENABLE); while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); sum += ADC_GetConversionValue(ADC1); } return (uint16_t)(sum / 10); } // 计算电压：V = (ADC_Value / 4095) × 3.3V float voltage = (float)Adc_GetValue() * 3.3f / 4095.0f;

4.4 I2C通信：AT24C02读写时序与应答处理

I2C1（PB6/PB7）初始化：

• 开漏输出模式：GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD；
• 上拉电阻：必须外接4.7kΩ（板载未焊则通信必败）；
• 时钟频率：I2C_InitStructure.I2C_ClockSpeed = 100000（100kHz标准模式）。

写入AT24C02关键步骤：

1. 发送起始信号；
2. 发送器件地址（0xA0，写模式）；
3. 等待从机应答（ACK）；
4. 发送内存地址（高字节）；
5. 等待ACK；
6. 发送内存地址（低字节）；
7. 等待ACK；
8. 发送数据字节；
9. 等待ACK；
10. 发送停止信号。

// 写一字节到AT24C02指定地址 uint8_t AT24C02_WriteByte(uint16_t addr, uint8_t data) { I2C_GenerateSTART(I2C1, ENABLE); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(I2C1, 0xA0, I2C_Direction_Transmitter); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); I2C_SendData(I2C1, (uint8_t)(addr >> 8)); // 高地址 while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(I2C1, (uint8_t)(addr & 0xFF)); // 低地址 while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(I2C1, data); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_GenerateSTOP(I2C1, ENABLE); return 0; // 成功 }

常见问题：I2C_CheckEvent()返回失败，多因SCL/SDA被拉低（上拉电阻缺失或短路），用万用表测PB6/PB7对地电压应为3.3V（空闲态）。

5. 常见问题排查：六个模块各一个致命翻车点

5.1 LED不亮：不是代码问题，是硬件供电链断裂

现象：GPIO_SetBits(GPIOC, GPIO_Pin_13)执行后，PC13电压仍为0V。
原因：

• 板载LED限流电阻虚焊（常见于廉价核心板）；
• PC13所在PORTC电源引脚（VDD3、VSS3）未接入3.3V（检查板子背面是否有跳线帽短接VDD3到3.3V）；
• 更隐蔽：PC13被调试器（SWD）占用，GPIO_PinRemapConfig()未在main()开头执行。
  解决：

1. 用万用表二极管档测LED两端，确认正向导通；
2. 测PC13对地电压，若为0V，测VDD3是否3.3V；
3. 在main()第一行添加GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE)。

5.2 按键无响应：PA0被ADC悄悄“劫持”

现象：GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0)始终返回1（高电平）。
原因：

• Adc_Init()中将PA0配置为GPIO_Mode_AIN（模拟输入），此时数字输入功能被禁用；
• 即使后续调用GPIO_Init()切回浮空输入，若未重新使能PORTA时钟，PA0仍为高阻态。
  解决：

1. 按键扫描前，确保PA0为数字输入：

RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; // 浮空输入 GPIO_Init(GPIOA, &GPIO_InitStructure);

2. 永远不要让ADC和按键共用同一引脚而不切换模式。

5.3 串口打印乱码：波特率计算与实际时钟不符

现象：printf("Hello")在串口助手中显示\u0000\u0000。
原因：

• 实际晶振频率≠8MHz（如板载为6MHz），但system_stm32f10x.c中HSE_VALUE仍为8000000；
• USARTDIV计算错误：DIV = (72000000 / (16 × 9600)) = 46.875，但寄存器只取整数部分46，小数部分0.875导致误差。
  解决：

1. 用示波器测PA9方波周期，反推实际波特率；
2. 修改USART_InitStruct.USART_BaudRate为精确值：

// 72MHz下9600波特率精确值：DIV = 72000000/(16×9600) = 468.75 → 整数468，小数0.75→MANTISSA=468, FRACTION=12（0.75×16） USART_InitStruct.USART_BaudRate = 9600; // 或手动设置DIV寄存器： USART1->BRR = (468 << 4) | 12; // MANTISSA=468, FRACTION=12

5.4 ADC采样值恒为0：参考电压未启用

现象：ADC_GetConversionValue()返回值始终为0。
原因：

• ADC_Cmd(ADC1, ENABLE)前未调用ADC_ResetCalibration()与ADC_StartCalibration()；
• 更常见：ADC_TempSensorVrefintCmd(ENABLE)未开启，导致内部参考电压未建立。
  解决：

ADC_DeInit(ADC1); ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); ADC_Cmd(ADC1, ENABLE); ADC_TempSensorVrefintCmd(ENABLE); // 关键！启用内部Vref

5.5 I2C通信失败：上拉电阻缺失或值过大

现象：I2C_CheckEvent()超时返回失败，示波器测PB6/PB7波形为缓慢爬升斜线（非方波）。
原因：

• 未焊接4.7kΩ上拉电阻（SCL/SDA需上拉至3.3V）；
• 误用10kΩ以上电阻，导致上升时间过长（I2C标准模式要求Tr < 1000ns）。
  解决：

1. 目视检查PB6/PB7附近是否有4.7kΩ贴片电阻（0805封装）；
2. 用万用表测PB6对3.3V电阻，应为4.7kΩ（若无穷大则未焊）；
3. 若已焊，测PB6空闲态电压，应为3.3V（若为0V则短路）。

6. 验收与答辩：用三张表、一个技巧、一次全流程演示征服评委

6.1 功能验收清单：对照表逐项打钩，拒绝“大概能跑”

将例程六大模块拆解为可量化验收项，制作《功能验收表》，答辩时逐项演示并勾选：

表格中“证据”栏必须为真实截图或示波器照片，禁止P图。评委可随时抽查任意一项现场演示。

6.2 性能参数表：用数据说话，终结“感觉还行”

嵌入式项目验收必须有硬指标。本例程性能参数经实测（Keil v5.37 + J-Link V10）：

测量方法：

• 中断延迟：在SysTick_Handler()首行插入GPIO_ResetBits(GPIOC, GPIO_Pin_14)，PC14接示波器，测高电平宽度；
• ADC周期：在Adc_GetValue()循环前后各置位/复位PC14，测脉冲宽度。

6.3 答辩演示技巧：用“故障注入法”证明你真懂

评委最怕学生背稿。我的做法是：主动制造一个典型故障，再现场修复。例如：

1. 第一步：演示正常功能——点亮LED、按键响应、串口通信；
2. 第二步：注入故障——注释掉GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE)，重启；
3. 第三步：现象描述——“现在LED不亮，按键无响应，但串口仍有输出，说明问题出在PA0/PC13引脚复用冲突”；
4. 第四步：定位分析——打开startup_stm32f10x_md.s，指出Reset_Handler调用顺序；查看system_stm32f10x.c中时钟配置；
5. 第五步：修复验证——取消注释，重新下载，LED立即点亮。

此过程耗时90秒，却比讲10分钟原理更有说服力。因为故障现象、分析路径、修复动作全部真实，评委无法质疑你是否真正理解底层。

6.4 从那以后我每次交付嵌入式项目，都强制走一遍这三步

• 第一步：硬件自检表——用万用表测所有电源引脚（VDD/VSS）、晶振两端（应有2~3V交流信号）、SWDIO/SWCLK对地电压（应为3.3V）；
• 第二步：最小闭环验证——不写任何业务代码，先确保SysTick能翻转LED、串口能收发单字节、按键能触发中断；
• 第三步：压力测试——所有模块同时运行48小时，用串口持续打印时间戳与ADC值，监控是否出现丢包、采样跳变、死机。

这三步曾让我在某次课程设计答辩中，提前30分钟结束演示，评委追问：“你们怎么保证长期稳定性？”我直接打开48小时日志文件，指着第32小时的ADC异常点说：“这里我们发现了PCB布线导致的电源耦合干扰，已在VDDA加了10μF钽电容修复。”——那一刻我知道，这份STM32F103RCT6例程，真的成了我嵌入式路上的后悔药。希望帮到你。

本文还有配套的精品资源，点击获取