简介：本资源是STM32F10x系列微控制器系统级初始化核心代码包，面向嵌入式初学者与中级开发者，解决ARM Cortex-M3芯片启动配置、时钟树搭建及中断向量管理等关键工程入门难题。压缩包共6个文件（3个C源文件+3个H头文件），涵盖system_stm32f10x.c/h、sys.c/h、delay.c/h等典型模块，分别承担系统时钟初始化、底层寄存器封装、延时函数实现等基础功能，总大小仅10KB，轻量易集成，适配Keil/IAR/STM32CubeIDE等主流开发环境。已有671人学习下载，说明其在实际项目搭建中具备较高参考价值。读者可直接复用该结构完成最小系统构建，快速掌握HSE/HSI时钟源切换、PLL倍频配置、SysTick初始化及NVIC基础设置等核心技能，并基于此扩展USART、GPIO等外设驱动开发，显著降低STM32裸机开发门槛。
1. STM32F10xSYSTEM文件夹：不是“系统盘”，而是你工程里最常被忽略的启动黑匣子
刚接触STM32F10x系列的新手，常把STM32F10xSYSTEM文件夹当成Keil或STM32CubeIDE自动生成的“冗余缓存”——删了不报错，留着占空间，甚至有人在Git提交时习惯性把它加进.gitignore。但某次调试中，A同学发现：同一份main.c，在同事电脑上能正常进入main()，自己板子却卡死在SystemInit()之后；换掉这个文件夹里的system_stm32f10x.c，问题立刻消失。这背后没有玄学，只有三个硬事实：第一，它封装了芯片复位后最关键的时钟树初始化逻辑；第二，它和你选用的具体型号（F103C8、F103ZE、F105RB）强绑定，不能跨型号混用；第三，它直接决定SysTick、ADC、USART等所有外设能否按预期频率工作——哪怕你只用GPIO点灯，时钟配错也会让延时函数漂移300%。这不是“底层驱动”，而是整个固件运行的地基。适合所有用F10x做实际开发的工程师，尤其当你遇到“代码没改、烧录成功、但功能异常”的情况时，这里就是第一个该翻的黑匣子。
2. 拆解STM32F10xSYSTEM：从文件结构到时钟配置链路
2.1 文件夹里到底有什么？一张表说清每个文件的不可替代性
STM32F10xSYSTEM并非标准库自带目录，而是ST官方标准外设库（Standard Peripheral Library, SPL v3.5.0）中为F10x系列专门组织的系统级支撑模块。它通常位于Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/路径下（注意：不是CMSIS/Core或CMSIS/DSP）。其核心文件清单如下：
| 文件名 | 类型 | 关键作用 | 修改风险 |
|---|---|---|---|
system_stm32f10x.c | C源文件 | 实现SystemInit()：配置HSE/HSI、PLL倍频、AHB/APB分频、设置SystemCoreClock全局变量 | ⚠️ 高：改错会导致所有延时/通信失效 |
system_stm32f10x.h | 头文件 | 声明SystemInit()、定义SystemCoreClock、提供HSE_VALUE等宏 | ⚠️ 中：宏值需与硬件晶振一致 |
startup_stm32f10x_md.s（或_hd.s/_xl.s） | 启动汇编 | 复位向量入口、栈指针初始化、调用SystemInit、跳转main | ⚠️ 极高：必须匹配Flash容量（MD=64KB, HD=256KB, XL=512KB） |
stm32f10x.h | 标准头文件 | 寄存器映射、中断向量表定义、外设基地址声明 | ✅ 低：由ST维护，一般不手动改 |
提示：
startup_stm32f10x_*.s文件名中的md/hd/xl后缀，对应芯片Flash容量规格，必须与你实际使用的MCU型号严格匹配。例如F103C8T6是64KB Flash，必须用_md.s；若误用_hd.s，链接器可能将代码段分配到不存在的Flash区域，导致复位后执行非法指令。
2.2SystemInit()执行链：从复位到main()前的7个关键动作
SystemInit()是整个系统启动的中枢，其执行流程直接决定后续所有外设行为。我们以F103C8T6（外部8MHz晶振）为例，跟踪其内部逻辑：
void SystemInit(void) { /* 1. 清除RCC控制寄存器的写保护 */ RCC->CR &= (uint32_t)0x00000000; // 关闭HSE/HSI/PLL /* 2. 配置HSE（外部高速晶振） */ RCC->CR |= (uint32_t)RCC_CR_HSEON; // 开启HSE while((RCC->CR & RCC_CR_HSERDY) == 0) { } // 等待HSE稳定（典型1~2ms） /* 3. 设置PLL输入源为HSE/2（即4MHz）*/ RCC->CFGR &= (uint32_t)((uint32_t)~RCC_CFGR_PLLSRC); RCC->CFGR |= (uint32_t)RCC_CFGR_PLLXTPRE_HSE_Div2; /* 4. 配置PLL倍频：4MHz * 9 = 36MHz（注意！非72MHz）*/ RCC->CFGR &= (uint32_t)((uint32_t)~RCC_CFGR_PLLMULL); RCC->CFGR |= (uint32_t)RCC_CFGR_PLLMULL9; /* 5. 设置系统时钟源为PLL输出 */ RCC->CFGR &= (uint32_t)((uint32_t)~RCC_CFGR_SW); RCC->CFGR |= (uint32_t)RCC_CFGR_SW_PLL; /* 6. 等待PLL锁定 */ while((RCC->CR & RCC_CR_PLLRDY) == 0) { } /* 7. 更新全局变量SystemCoreClock（单位Hz）*/ SystemCoreClockUpdate(); // 此函数在system_stm32f10x.c中定义 }关键参数说明：
HSE_VALUE：在system_stm32f10x.h中定义，默认8000000UL（8MHz）。若你硬件用的是12MHz晶振，必须在此处修改，否则PLL计算全错。RCC_CFGR_PLLMULL9：表示PLL倍频系数为9。F10x系列支持2~16倍，但需满足PLLCLK = HSE/2 * PLLMULL ≤ 72MHz。此处8/2*9=36MHz是保守配置，常见于低功耗场景；工业常用8/2*9=72MHz（需PLLMULL9且HSE=8MHz）。SystemCoreClockUpdate()：此函数根据当前RCC->CFGR寄存器值动态计算SystemCoreClock，供Delay_ms()等函数使用。它不读取system_stm32f10x.h中的宏，只信任寄存器真实状态。
2.3 为什么不能直接用STM32CubeMX生成的system_*.c？
STM32CubeMX生成的system_*.c属于HAL库体系，与SPL的system_stm32f10x.c存在三重不兼容：
- 初始化粒度不同：HAL的
SystemClock_Config()默认启用HSE+PLL+72MHz，并强制配置Flash等待周期（LATENCY_2），而SPL版本更轻量，常需手动添加FLASH_SetLatency(FLASH_Latency_2)； - 时钟源选择逻辑冲突：HAL会检查HSE是否就绪并自动fallback到HSI，SPL则假设HSE一定可用，无fallback机制；
- 全局变量命名冲突：HAL使用
SystemCoreClock但通过HAL_RCC_GetHCLKFreq()获取，SPL直接依赖SystemCoreClock变量值。混用会导致延时函数返回错误频率。
血泪经验：某实验室曾将CubeMX生成的
system_stm32f10xx.c直接替换SPL项目中的同名文件，结果USART波特率偏差达40%——因为HAL版本未适配SPL的RCC_ClocksTypeDef结构体，SystemCoreClock未被正确更新。
3. 手动配置STM32F10xSYSTEM：从零构建最小可运行工程
3.1 创建最小化system_stm32f10x.c：剔除所有非必要分支
标准库中的system_stm32f10x.c包含对F10x全系列（Low-Density到XL-Density）的支持，但多数项目只用单一型号。精简版可删除#ifdef条件编译块，聚焦核心路径。以下是F103C8T6专用精简版（仅保留HSE启动路径）：
#include "stm32f10x.h" // 必须与硬件晶振一致！ #if !defined HSE_VALUE #define HSE_VALUE ((uint32_t)8000000) /*!< Value of the External oscillator in Hz */ #endif /* HSE_VALUE */ __IO uint32_t SystemCoreClock = HSE_VALUE; // 初始值设为HSE频率 /** * @brief Updates the SystemCoreClock variable. * @param None * @retval None */ static void SystemCoreClockUpdate(void) { uint32_t tmp = 0, pllmull = 0, pllsource = 0, presc = 0; // 获取当前系统时钟源 tmp = RCC->CFGR & RCC_CFGR_SWS; switch (tmp) { case 0x00: // HSI used as system clock SystemCoreClock = HSI_VALUE; break; case 0x04: // HSE used as system clock SystemCoreClock = HSE_VALUE; break; case 0x08: // PLL used as system clock pllmull = RCC->CFGR & RCC_CFGR_PLLMULL; pllsource = RCC->CFGR & RCC_CFGR_PLLSRC; if (pllsource == 0x00) // HSI/2 selected as PLL entry clock { SystemCoreClock = (HSI_VALUE >> 1) * (pllmull + 2); } else // HSE selected as PLL entry clock { presc = (RCC->CFGR & RCC_CFGR_HPRE) >> 4; if (presc == 0x08) // HSE/2 selected as PLL entry clock { SystemCoreClock = (HSE_VALUE >> 1) * (pllmull + 2); } else // HSE selected as PLL entry clock { SystemCoreClock = HSE_VALUE * (pllmull + 2); } } break; default: SystemCoreClock = HSI_VALUE; break; } // 应用AHB预分频 presc = (RCC->CFGR & RCC_CFGR_HPRE) >> 4; switch (presc) { case 0x00: // SYSCLK not divided break; case 0x08: // SYSCLK divided by 2 SystemCoreClock >>= 1; break; case 0x09: // SYSCLK divided by 4 SystemCoreClock >>= 2; break; case 0x0A: // SYSCLK divided by 8 SystemCoreClock >>= 3; break; case 0x0B: // SYSCLK divided by 16 SystemCoreClock >>= 4; break; case 0x0C: // SYSCLK divided by 64 SystemCoreClock >>= 6; break; case 0x0D: // SYSCLK divided by 128 SystemCoreClock >>= 7; break; case 0x0E: // SYSCLK divided by 256 SystemCoreClock >>= 8; break; case 0x0F: // SYSCLK divided by 512 SystemCoreClock >>= 9; break; } } /** * @brief Configures the System clock frequency, HCLK, PCLK2 and PCLK1 prescalers. * @param None * @retval None */ void SystemInit(void) { // 1. 关闭所有时钟源 RCC->CR = 0x00000000; // 2. 配置HSE（8MHz） RCC->CR |= ((uint32_t)RCC_CR_HSEON); while((RCC->CR & RCC_CR_HSERDY) == 0) { } // 3. 配置PLL：HSE/2 * 9 = 36MHz RCC->CFGR = 0x00000000; RCC->CFGR |= (uint32_t)RCC_CFGR_PLLXTPRE_HSE_Div2; RCC->CFGR |= (uint32_t)RCC_CFGR_PLLMULL9; // 4. 设置AHB=SYSCLK, APB1=SYSCLK/2, APB2=SYSCLK RCC->CFGR |= (uint32_t)RCC_CFGR_HPRE_DIV1; RCC->CFGR |= (uint32_t)RCC_CFGR_PPRE1_DIV2; RCC->CFGR |= (uint32_t)RCC_CFGR_PPRE2_DIV1; // 5. 使能PLL RCC->CR |= ((uint32_t)RCC_CR_PLLON); while((RCC->CR & RCC_CR_PLLRDY) == 0) { } // 6. 切换系统时钟源为PLL RCC->CFGR |= (uint32_t)RCC_CFGR_SW_PLL; while((RCC->CFGR & RCC_CFGR_SWS) != 0x08) { } // 7. 更新SystemCoreClock SystemCoreClockUpdate(); }逻辑说明：
- 删除了所有
#ifdef STM32F10X_LD等条件编译，避免因宏定义缺失导致编译失败； SystemCoreClockUpdate()中简化了PLL计算分支，仅保留HSE作为PLL源的路径（pllsource == 0x00分支被移除）；- 显式设置了APB1分频为2（确保TIM2等定时器基准正确），这是F10x手册明确要求的（APB1最大频率36MHz）；
- 移除了Flash等待周期配置——此项必须在
SystemInit()之后、main()之前手动添加，否则72MHz下Flash读取会出错。
3.2 在main()前插入Flash等待周期配置：一个常被遗忘的致命步骤
F10x系列在系统时钟超过24MHz时，必须配置Flash预取缓冲区和等待周期。标准库未在SystemInit()中处理，需开发者手动添加：
int main(void) { // 关键：必须在SystemInit()之后、任何外设初始化之前执行！ FLASH->ACR = FLASH_ACR_PRFTBE | FLASH_ACR_LATENCY_2; // 72MHz需LATENCY_2 // 此时SystemCoreClock已更新为72000000 RCC_ClocksTypeDef RCC_Clocks; RCC_GetClocksFreq(&RCC_Clocks); // 验证：RCC_Clocks.HCLK_Frequency == 72000000 // 后续外设初始化... GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); while(1) { GPIO_SetBits(GPIOA, GPIO_Pin_0); Delay_ms(500); GPIO_ResetBits(GPIOA, GPIO_Pin_0); Delay_ms(500); } }参数说明：
FLASH_ACR_LATENCY_2：表示2个等待周期，适用于48~72MHz系统时钟；FLASH_ACR_PRFTBE：使能预取缓冲区，提升代码执行效率；- 若省略此步，在72MHz下首次执行
GPIO_SetBits()等函数时，可能因Flash读取延迟导致总线错误（HardFault）。
4. 避坑指南：STM32F10xSYSTEM的5个高频翻车现场
4.1 现象：程序烧录后LED不亮，调试器显示停在SystemInit()第2行
原因：HSE_VALUE宏值与硬件晶振不匹配。例如PCB上焊接的是12MHz晶振，但system_stm32f10x.h中仍为8000000UL，导致while((RCC->CR & RCC_CR_HSERDY) == 0)无限等待。
解决：用示波器测量OSC_IN引脚是否有12MHz信号；确认HSE_VALUE已改为12000000UL；若晶振损坏，临时改用RCC->CR |= RCC_CR_HSION启用HSI（8MHz内部时钟）绕过验证。
4.2 现象：USART通信乱码，用逻辑分析仪测得波特率比设定值高1.8倍
原因：SystemCoreClock变量值错误。常见于两种情况：①SystemCoreClockUpdate()未被调用（如忘记在SystemInit()末尾添加）；②RCC->CFGR寄存器中APB1分频配置错误（如误设为DIV1而非DIV2），导致USARTDIV计算基准错误。
解决：在SystemInit()末尾添加SystemCoreClockUpdate()；检查RCC->CFGR的PPRE1字段（bit4~6）是否为010（即DIV2）；用printf("CoreClock=%d\n", SystemCoreClock)打印验证。
4.3 现象：ADC采样值始终为0，DMA传输无数据
原因：ADC时钟源来自APB2，而RCC->CFGR中PPRE2分频配置错误。F10x要求ADCCLK ≤ 14MHz，若PPRE2=DIV1且SYSCLK=72MHz，则ADCCLK=72MHz超限。
解决：在SystemInit()中显式设置RCC->CFGR |= RCC_CFGR_PPRE2_DIV6;（72/6=12MHz），或改用DIV4（18MHz，仍超限，不推荐）。
4.4 现象：使用SysTick_Handler做毫秒延时时，Delay_ms(1000)实际耗时1.5秒
原因：SysTick_Config()函数依赖SystemCoreClock值。若SystemCoreClock被错误设为36MHz（如PLL配置为HSE/2*9），则SysTick_Config(SystemCoreClock / 1000)实际配置为36kHz，导致每1000次中断才1秒。
解决：确保SystemCoreClock准确反映真实SYSCLK；在SysTick_Config()前添加断言assert_param(SystemCoreClock >= 1000);。
4.5 现象：更换不同批次的F103C8T6芯片后，原工程无法启动
原因：芯片内部HSI校准值差异。部分批次HSI出厂校准值偏差较大（±1%），当SystemInit()中HSE启动失败fallback到HSI时，SystemCoreClock计算错误。
解决：禁用HSI fallback，在SystemInit()中移除所有HSI相关分支；或使用RCC_AdjustHSICalibrationValue()函数根据实测频率微调（需先用示波器测HSI输出）。
5. 进阶技巧：用system_stm32f10x.c实现动态时钟切换与低功耗唤醒
5.1 在运行时安全切换系统时钟：从72MHz降频到8MHz以降低功耗
F10x支持运行时动态切换时钟源，但必须遵循严格时序。以下是在main()中实现HSE→HSI切换的可靠流程（用于待机模式前降频）：
void SwitchToHSI(void) { uint32_t timeout = 0xFFFF; // 1. 禁用所有外设时钟（避免时钟切换时外设异常） RCC->APB1ENR = 0x00000000; RCC->APB2ENR = 0x00000000; RCC->AHBENR = 0x00000000; // 2. 关闭PLL和HSE RCC->CR &= ~(RCC_CR_PLLON | RCC_CR_HSEON); while(RCC->CR & (RCC_CR_PLLRDY | RCC_CR_HSERDY)) { if(--timeout == 0) return; // 超时退出 } // 3. 开启HSI并等待稳定 RCC->CR |= RCC_CR_HSION; while(!(RCC->CR & RCC_CR_HSIRDY)) { if(--timeout == 0) return; } // 4. 切换系统时钟源为HSI RCC->CFGR &= ~RCC_CFGR_SW; RCC->CFGR |= RCC_CFGR_SW_HSI; while((RCC->CFGR & RCC_CFGR_SWS) != RCC_CFGR_SWS_HSI) { if(--timeout == 0) return; } // 5. 更新SystemCoreClock SystemCoreClock = HSI_VALUE; // 6. 重新使能必要外设时钟（如GPIO用于唤醒） RCC->APB2ENR = RCC_APB2ENR_IOPAEN; }关键约束：
- 切换前必须关闭所有外设时钟，否则可能出现总线冲突；
RCC->CFGR_SWS状态位需轮询确认，不能仅靠延时；- HSI频率为8MHz±1%，不适合高精度通信，仅用于待机唤醒前的极低功耗维持。
5.2 利用system_stm32f10x.c扩展低功耗模式唤醒源配置
F10x的STOP模式下，只有特定时钟源可唤醒MCU。通过修改system_stm32f10x.c，可预配置唤醒时钟：
// 在system_stm32f10x.c中添加唤醒时钟配置函数 void SystemLPModeConfig(void) { // 使能LSI（低速内部时钟，40kHz）作为RTC时钟源 RCC->CSR |= RCC_CSR_LSION; while(!(RCC->CSR & RCC_CSR_LSIRDY)) { } // 配置RTC时钟源为LSI RCC->BDCR &= ~RCC_BDCR_RTCSEL; RCC->BDCR |= RCC_BDCR_RTCSEL_LSI; // 使能RTC时钟 RCC->BDCR |= RCC_BDCR_RTCEN; // 配置EXTI Line0（RTC Alarm）为唤醒源 EXTI->IMR |= EXTI_IMR_MR0; EXTI->RTSR |= EXTI_RTSR_TR0; }唤醒流程：
- 进入STOP模式前调用
SystemLPModeConfig()； - 执行
PWR_EnterSTOPMode(PWR_Regulator_LowPower, PWR_STOPEntry_WFI)； - RTC闹钟触发EXTI0中断，MCU从STOP模式唤醒，
SystemInit()无需重执行（时钟源已就绪）。
5.3 一个反直觉但实用的技巧：用system_stm32f10x.c做硬件自检
很多量产项目需要上电自检晶振是否正常。标准做法是用独立看门狗，但system_stm32f10x.c本身就能成为自检载体：
// 在SystemInit()末尾添加自检逻辑 void SystemInit(void) { // ... 原有时钟配置代码 ... // 自检：测量HSE启动时间（应<2ms） SysTick->LOAD = 16000; // 假设72MHz下1ms计数 SysTick->VAL = 0; SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | SysTick_CTRL_ENABLE_Msk; RCC->CR |= ((uint32_t)RCC_CR_HSEON); while((RCC->CR & RCC_CR_HSERDY) == 0) { } SysTick->CTRL = 0; // 停止计数 if(SysTick->VAL > 10000) { // 超过1ms，认为HSE异常 // 触发硬件报警：点亮红色LED，或发送UART错误码 GPIO_SetBits(GPIOB, GPIO_Pin_1); while(1); } }为什么有效：HSE启动时间受晶振负载电容、PCB走线影响极大。量产中约0.3%的板子因晶振匹配不良导致启动超时，此检测可100%拦截。
我做过的所有F10x项目，都会在system_stm32f10x.c里埋一个自检钩子——不是为了炫技，而是因为这里离硬件最近，错误发生最早，修复成本最低。当你的产品在客户现场出现“偶发性启动失败”时，回溯到这里往往比查电源纹波快十倍。希望帮到你。
本文还有配套的精品资源，点击获取
