简介STM32F10x标准库3.6.0最终版是ST官方为STM32F10X系列推出的标准外设库面向使用STM32芯片进行嵌入式开发的工程师、高校学生及电子爱好者。它把底层寄存器操作封装成库函数开发者无需逐位配置寄存器直接调用即可完成GPIO、定时器、串口、ADC等外设功能能显著降低开发门槛、提升代码可读性与可移植性适合从入门到进阶的固件开发场景。资源包共960个文件约21.25MB以349个c源文件与277个h头文件为主体另含txt说明、s汇编、lsl链接脚本、ld与icf分散加载文件、uvproj与ewp等工程文件覆盖IAR、Keil等主流工具链并附有操作说明书与chm帮助文档。目前已有2820人学习下载。借助这套完整库文件与配套说明读者可快速搭建标准工程模板理解外设驱动结构对照示例完成项目移植与调试是学习STM32固件开发的实用参考。1. 从一块“点不亮”的板子说起为什么我还在用 STM32F10x 标准库 3.6.0上周帮一个学弟看他那块 STM32F103C8T6 最小系统板现象很典型Keil 里编译零错误零警告下载器也认芯片可就是 LED 不闪串口一个字节都吐不出来。他装的是最新版的 CubeMX 加 HAL 库引脚配置界面点得飞起但生成代码后连SystemInit里的时钟树都没配对外部晶振被当成内部 HSI 跑主频卡在 8MHz延时函数全乱套。这种“环境装好了、代码也下了、就是跑不起来”的玄学现场我每年都要碰上好几回。STM32F10x 标准库 3.6.0 是 ST 官方在 2011 年前后放出的最后一个标准外设库版本覆盖 F101/102/103/105/107 全系。它不像 HAL 那样层层抽象寄存器操作直给启动文件、时钟配置、外设驱动全在源码里摊开特别适合想搞明白“芯片到底怎么动起来”的人。但它的安装和工程搭建有一套固定套路版本选错、启动文件拿错、宏定义漏写都会让你卡在“编译通过但运行异常”的坑里。这篇笔记就把这套环境的搭建过程从头到尾捋一遍从下载哪个包、Keil 里怎么配、到跑通第一个串口输出每一步都落到能直接抄的命令和配置上。2. 装前准备STM32F10x 标准库 3.6.0 的获取与目录结构2.1 版本确认与下载渠道标准库 3.6.0 的官方包名通常叫STM32F10x_StdPeriph_Lib_V3.6.0压缩后大概 20MB 出头解压后接近 100MB。网上流传的版本很杂有 3.5.0 改的、有把启动文件替换过的我一般只认两种来源一是 ST 官网历史归档区需要注册账号但文件最干净二是某些高校实验室或开源镜像站里带 MD5 校验的副本。下载完先对一下压缩包内Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/下的stm32f10x.h看版本注释是不是V3.6.0再确认startup/arm/目录里启动文件齐全。提示如果拿到的是V3.5.0改名的包stm32f10x.h里会缺STM32F10X_MD之外的密度定义编译时容易报#error Please select first the target STM32F10x device used in your application。2.2 解压后的目录该看哪几个解压后目录结构大致如下我按重要性排个序目录/文件作用是否必须Libraries/CMSIS/CM3/CoreSupport/内核头文件core_cm3.h等必须Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/stm32f10x.h、system_stm32f10x.c必须Libraries/STM32F10x_StdPeriph_Driver/外设驱动源码src/和头文件inc/按需Project/STM32F10x_StdPeriph_Template/官方工程模板含main.c、中断处理参考Utilities/STM32_EVAL/官方评估板驱动一般用不上可删我一般会把Libraries整个拷到工程目录下Project里的模板只用来对照启动文件和中断向量表的写法不直接拿来编译。这样工程目录干净换芯片型号时只改宏定义和启动文件不用动库本身。2.3 工具链版本选择Keil MDK 用哪个版本不翻车标准库 3.6.0 对编译器版本不挑但 Keil MDK 从 5.30 之后默认的 ARM Compiler 6 对老库的汇编启动文件支持有变化。我实测下来MDK 5.28 到 5.36 配 ARM Compiler 5最稳启动文件startup_stm32f10x_md.s直接能编。如果只有新版 MDK需要在Options for Target → Target里把编译器切回Use default compiler version 5或者手动指定ARMCC路径。# 检查 Keil 安装目录下是否有 ARMCC 文件夹Compiler 5 的标志 ls C:/Keil_v5/ARM/ARMCC/bin/armcc.exe # 如果只有 ARMCLANG说明默认是 Compiler 6需要单独装 Legacy Support上面这条命令用来确认编译器版本。ARMCC是 Compiler 5 的可执行文件ARMCLANG是 Compiler 6。标准库 3.6.0 的启动文件里用了AREA、DCD这类 ARM 汇编伪指令Compiler 6 虽然兼容大部分但个别分散加载文件会报错。我一般直接装 Keil 的 Legacy Support 包省得改启动文件。3. 工程搭建从零建一个能编译的 STM32F10x 标准库工程3.1 新建工程与芯片型号选择打开 Keil MDKProject → New uVision Project选一个空目录芯片型号选STMicroelectronics → STM32F103C8如果是其他容量按实际选比如STM32F103ZE。弹窗问是否复制Startup文件时选否因为我们要用标准库自带的启动文件不用 Keil 的。建完工程后目录树里只有一个Target 1下面空荡荡。接下来手动建分组右键Target 1 → Manage Project Items建这几个组Startup放启动文件CMSIS放内核和系统文件StdPeriph_Driver放外设驱动User放main.c、中断处理、配置文件分组名随意但建议按这个来后面换芯片时一眼能看出哪个组要动。3.2 添加文件哪些 .c 必须加哪些可以不加往各组里加文件时最容易漏的是system_stm32f10x.c和stm32f10x_it.c。我列一下最小系统的文件清单# Startup 组根据芯片容量选一个 Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/startup/arm/startup_stm32f10x_md.s # CMSIS 组 Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/system_stm32f10x.c Libraries/CMSIS/CM3/CoreSupport/core_cm3.c # StdPeriph_Driver 组按需加这里以 GPIO、USART、RCC 为例 Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_gpio.c Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_usart.c Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_rcc.c # User 组 Project/STM32F10x_StdPeriph_Template/stm32f10x_it.c # main.c 自己新建启动文件的选择看芯片容量md是中容量64KB/128KB Flashhd是大容量256KB以上ld是小容量32KB以下。选错了会在链接阶段报No section matches selector或者中断向量表对不上程序跑飞。core_cm3.c在新版库里其实可以不加因为core_cm3.h里已经用__INLINE内联了大部分函数但加上也不影响我习惯留着。3.3 头文件路径与宏定义两个必须配的地方文件加完后点Options for Target → C/C在Include Paths里加这几条.\Libraries\CMSIS\CM3\CoreSupport .\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x .\Libraries\STM32F10x_StdPeriph_Driver\inc .\User然后在Define框里填两个宏USE_STDPERIPH_DRIVER, STM32F10X_MDUSE_STDPERIPH_DRIVER是告诉stm32f10x.h去包含stm32f10x_conf.h不加的话标准库的外设函数声明不会展开。STM32F10X_MD是芯片密度定义必须和启动文件匹配。如果是大容量芯片改成STM32F10X_HD小容量改STM32F10X_LD。注意这两个宏之间用英文逗号分隔不要用中文逗号否则 Keil 会把它当成一个整体宏编译时报identifier USE_STDPERIPH_DRIVER, STM32F10X_MD is undefined。3.4 时钟配置system_stm32f10x.c 里改哪一行标准库默认用外部 8MHz 晶振PLL 倍频到 72MHz。如果你板子上是 12MHz 晶振或者用内部 HSI需要改system_stm32f10x.c里的SetSysClockTo72()函数。我一般不动这个文件而是在main.c开头调用SystemInit()后用RCC_GetClocksFreq()读一下实际频率确认时钟树对了再往下跑。#include stm32f10x.h #include stm32f10x_rcc.h int main(void) { SystemInit(); // 初始化时钟默认 72MHz RCC_ClocksTypeDef clocks; RCC_GetClocksFreq(clocks); // 如果 clocks.SYSCLK_Frequency 不是 72000000说明晶振或 PLL 配置有问题 while (1) { // 主循环 } }SystemInit()在启动文件里被Reset_Handler调用执行的是system_stm32f10x.c里的时钟初始化。RCC_GetClocksFreq()把当前各总线频率填进结构体调试时在 Watch 窗口看clocks.SYSCLK_Frequency最直接。如果读出来是 8000000说明外部晶振没起振程序自动切回了 HSI。4. 外设驱动配置GPIO、USART 和中断的落地写法4.1 GPIO 初始化结构体里每个成员的含义标准库的 GPIO 初始化靠GPIO_InitTypeDef结构体填完传给GPIO_Init()。以点亮 PC13 的 LED 为例GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); // 开 GPIOC 时钟 gpio.GPIO_Pin GPIO_Pin_13; gpio.GPIO_Speed GPIO_Speed_50MHz; // 输出速度LED 用 2MHz 也行 gpio.GPIO_Mode GPIO_Mode_Out_PP; // 推挽输出 GPIO_Init(GPIOC, gpio); GPIO_SetBits(GPIOC, GPIO_Pin_13); // 输出高电平灭灯取决于硬件接法RCC_APB2PeriphClockCmd必须放在GPIO_Init之前否则寄存器写不进去现象就是“程序在跑但引脚没反应”。GPIO_Speed只在输出模式下有意义输入模式下随便填。GPIO_Mode常用值GPIO_Mode_Out_PP推挽输出、GPIO_Mode_IPU上拉输入、GPIO_Mode_AIN模拟输入。我见过有人把 LED 配成GPIO_Mode_IPU然后纳闷为什么灯不亮——模式选错了引脚根本没往外驱动。4.2 USART 配置波特率算不对的排查思路串口是调试阶段最重要的外设。标准库配 USART1 的代码如下USART_InitTypeDef usart; GPIO_InitTypeDef gpio; // PA9 TX, PA10 RX RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); gpio.GPIO_Pin GPIO_Pin_9; gpio.GPIO_Mode GPIO_Mode_AF_PP; // 复用推挽 gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); gpio.GPIO_Pin GPIO_Pin_10; gpio.GPIO_Mode GPIO_Mode_IN_FLOATING; // 浮空输入 GPIO_Init(GPIOA, gpio); usart.USART_BaudRate 115200; usart.USART_WordLength USART_WordLength_8b; usart.USART_StopBits USART_StopBits_1; usart.USART_Parity USART_Parity_No; usart.USART_HardwareFlowControl USART_HardwareFlowControl_None; usart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, usart); USART_Cmd(USART1, ENABLE);TX 引脚必须配成GPIO_Mode_AF_PPRX 配成GPIO_Mode_IN_FLOATING这是 F1 系列复用功能的固定要求。波特率算不对时先确认SystemCoreClock是不是 72000000再看RCC_GetClocksFreq()里PCLK2_Frequency的值。USART1 挂在 APB2 上如果 APB2 分频不是 1USART_Init内部算出来的分频系数会偏。我一般把SystemCoreClock在调试时打印出来确认是 72M 再往下查。4.3 中断配置NVIC 优先级分组别乱设用中断收串口数据时NVIC 配置容易出问题。标准库的写法NVIC_InitTypeDef nvic; NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); // 2 位抢占2 位响应 nvic.NVIC_IRQChannel USART1_IRQn; nvic.NVIC_IRQChannelPreemptionPriority 1; nvic.NVIC_IRQChannelSubPriority 1; nvic.NVIC_IRQChannelCmd ENABLE; NVIC_Init(nvic); USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); // 开接收中断NVIC_PriorityGroupConfig整个工程调一次就行别在多个文件里重复调否则后面的会覆盖前面的分组设置。抢占优先级高的可以打断低的响应优先级只在同抢占级下比较。如果中断进不去先查USART_ITConfig有没有开对应的中断源再查NVIC_IRQChannelCmd是不是ENABLE最后看stm32f10x_it.c里有没有写USART1_IRQHandler。5. 避坑与排查标准库 3.6.0 最常见的五个翻车现场5.1 编译报 “Please select first the target STM32F10x device”现象编译时stm32f10x.h里报错提示没有定义目标芯片。原因Define里漏了STM32F10X_MD或写成了STM32F10X_MD带空格。解决在Options for Target → C/C → Define里补上注意逗号后不要有空格写成USE_STDPERIPH_DRIVER,STM32F10X_MD。5.2 程序下载后不运行调试器停在 HardFault现象Keil 下载成功但点运行后 PC 指针跳到HardFault_Handler。原因启动文件和芯片容量不匹配中断向量表偏移错了或者system_stm32f10x.c里外部晶振频率和实际不符PLL 锁不住。解决确认启动文件后缀md/hd/ld和Define里的密度宏一致用示波器或万用表量晶振引脚确认起振临时把SetSysClockTo72()改成SetSysClockToHSI()排除晶振问题。5.3 串口输出乱码现象串口助手收到一堆乱码或者偶尔对几个字符。原因波特率不匹配、时钟频率不对、或者 TX/RX 接反。解决先确认串口助手波特率和代码里一致再确认SystemCoreClock是 72M最后交换 TX/RX 线序。我遇到过一块板子晶振是 12M 但代码按 8M 算PLL 倍频后主频变成 108M串口分频全乱改HSE_VALUE宏为12000000就好了。5.4 外设初始化后没反应现象GPIO 不输出、USART 不发数据、定时器不计数。原因外设时钟没开或者开了但开错了总线APB1/APB2。解决查RCC_APB1PeriphClockCmd和RCC_APB2PeriphClockCmd的参数。GPIO 全在 APB2USART1 在 APB2USART2/3 在 APB1TIM2~7 在 APB1TIM1/8 在 APB2。开错总线寄存器写不进去现象就是“代码在跑但外设不动”。5.5 中断服务函数写了但进不去现象stm32f10x_it.c里写了USART1_IRQHandler但断点不命中。原因中断向量表里的函数名和启动文件里的弱定义对不上或者 NVIC 没使能。解决确认函数名拼写和启动文件里DCD USART1_IRQHandler一致确认NVIC_Init里NVIC_IRQChannelCmd ENABLE确认USART_ITConfig开了对应中断源。如果用了USE_STDPERIPH_DRIVERstm32f10x_it.c里的函数名必须和startup_stm32f10x_md.s里的向量表完全一致大小写都不能错。6. 装完怎么验证从串口打印到 LED 闪烁的完整检查链环境搭完别急着写业务代码先跑一个最小验证程序把时钟、GPIO、串口、中断四条链路都过一遍。我一般按这个顺序来第一步确认时钟。在main()开头调用SystemInit()后用RCC_GetClocksFreq()读频率通过串口打印出来。如果串口还没通就点灯——用RCC_GetClocksFreq()的结果去算一个精确的软件延时闪灯频率对了说明时钟基本对。第二步验证 GPIO。写一个最简单的闪灯程序不调任何库函数直接操作GPIOB-ODR寄存器翻转。如果寄存器操作能亮但库函数不亮说明库文件没加对或者头文件路径有问题。第三步打通串口。用USART_SendData()发一个固定字符串串口助手收到就说明时钟、GPIO 复用、USART 配置全对。收不到就按第 5 章的排查顺序走一遍。第四步验证中断。开 USART1 接收中断发一个字符在USART1_IRQHandler里翻转另一个 LED。中断能进说明 NVIC 和向量表都对。下面这个验证程序把四步串在一起可以直接抄#include stm32f10x.h #include stm32f10x_rcc.h #include stm32f10x_gpio.h #include stm32f10x_usart.h void Delay(__IO uint32_t n) { while (n--); } int main(void) { // 1. 时钟验证 SystemInit(); RCC_ClocksTypeDef clocks; RCC_GetClocksFreq(clocks); // 2. GPIO 初始化PC13 推挽输出 GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); gpio.GPIO_Pin GPIO_Pin_13; gpio.GPIO_Speed GPIO_Speed_2MHz; gpio.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOC, gpio); // 3. USART1 初始化PA9/PA10115200 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); gpio.GPIO_Pin GPIO_Pin_9; gpio.GPIO_Mode GPIO_Mode_AF_PP; gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); gpio.GPIO_Pin GPIO_Pin_10; gpio.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, gpio); USART_InitTypeDef usart; usart.USART_BaudRate 115200; usart.USART_WordLength USART_WordLength_8b; usart.USART_StopBits USART_StopBits_1; usart.USART_Parity USART_Parity_No; usart.USART_HardwareFlowControl USART_HardwareFlowControl_None; usart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, usart); USART_Cmd(USART1, ENABLE); // 4. 打印时钟频率 char buf[64]; int len 0; uint32_t f clocks.SYSCLK_Frequency / 1000000; buf[len] S; buf[len] Y; buf[len] S; buf[len] :; buf[len] (f / 10) 0; buf[len] (f % 10) 0; buf[len] M; buf[len] \r; buf[len] \n; for (int i 0; i len; i) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, buf[i]); } // 5. 主循环闪灯 while (1) { GPIO_SetBits(GPIOC, GPIO_Pin_13); Delay(7200000); // 约 100ms 72MHz GPIO_ResetBits(GPIOC, GPIO_Pin_13); Delay(7200000); } }这段代码跑通的标准是串口助手收到SYS:72M同时 PC13 上的 LED 以大约 5Hz 的频率闪烁。如果串口收到的是SYS:08M说明外部晶振没起振程序跑在 HSI 上需要检查晶振电路和HSE_VALUE宏。如果串口没输出但灯在闪说明 GPIO 和时钟没问题问题在 USART 配置或接线。如果灯也不闪回到第 5 章从启动文件和宏定义开始查。从那以后我每次搭标准库工程都强制先跑一遍这个四步验证链确认时钟、GPIO、串口、中断全通了再写业务代码。这套流程帮我省掉了至少几十次“编译通过但跑不起来”的无效调试。希望帮到你。本文还有配套的精品资源点击获取
简介STM32F10x标准库3.6.0最终版是ST官方为STM32F10X系列推出的标准外设库面向使用STM32芯片进行嵌入式开发的工程师、高校学生及电子爱好者。它把底层寄存器操作封装成库函数开发者无需逐位配置寄存器直接调用即可完成GPIO、定时器、串口、ADC等外设功能能显著降低开发门槛、提升代码可读性与可移植性适合从入门到进阶的固件开发场景。资源包共960个文件约21.25MB以349个c源文件与277个h头文件为主体另含txt说明、s汇编、lsl链接脚本、ld与icf分散加载文件、uvproj与ewp等工程文件覆盖IAR、Keil等主流工具链并附有操作说明书与chm帮助文档。目前已有2820人学习下载。借助这套完整库文件与配套说明读者可快速搭建标准工程模板理解外设驱动结构对照示例完成项目移植与调试是学习STM32固件开发的实用参考。1. 从一块“点不亮”的板子说起为什么我还在用 STM32F10x 标准库 3.6.0上周帮一个学弟看他那块 STM32F103C8T6 最小系统板现象很典型Keil 里编译零错误零警告下载器也认芯片可就是 LED 不闪串口一个字节都吐不出来。他装的是最新版的 CubeMX 加 HAL 库引脚配置界面点得飞起但生成代码后连SystemInit里的时钟树都没配对外部晶振被当成内部 HSI 跑主频卡在 8MHz延时函数全乱套。这种“环境装好了、代码也下了、就是跑不起来”的玄学现场我每年都要碰上好几回。STM32F10x 标准库 3.6.0 是 ST 官方在 2011 年前后放出的最后一个标准外设库版本覆盖 F101/102/103/105/107 全系。它不像 HAL 那样层层抽象寄存器操作直给启动文件、时钟配置、外设驱动全在源码里摊开特别适合想搞明白“芯片到底怎么动起来”的人。但它的安装和工程搭建有一套固定套路版本选错、启动文件拿错、宏定义漏写都会让你卡在“编译通过但运行异常”的坑里。这篇笔记就把这套环境的搭建过程从头到尾捋一遍从下载哪个包、Keil 里怎么配、到跑通第一个串口输出每一步都落到能直接抄的命令和配置上。2. 装前准备STM32F10x 标准库 3.6.0 的获取与目录结构2.1 版本确认与下载渠道标准库 3.6.0 的官方包名通常叫STM32F10x_StdPeriph_Lib_V3.6.0压缩后大概 20MB 出头解压后接近 100MB。网上流传的版本很杂有 3.5.0 改的、有把启动文件替换过的我一般只认两种来源一是 ST 官网历史归档区需要注册账号但文件最干净二是某些高校实验室或开源镜像站里带 MD5 校验的副本。下载完先对一下压缩包内Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/下的stm32f10x.h看版本注释是不是V3.6.0再确认startup/arm/目录里启动文件齐全。提示如果拿到的是V3.5.0改名的包stm32f10x.h里会缺STM32F10X_MD之外的密度定义编译时容易报#error Please select first the target STM32F10x device used in your application。2.2 解压后的目录该看哪几个解压后目录结构大致如下我按重要性排个序目录/文件作用是否必须Libraries/CMSIS/CM3/CoreSupport/内核头文件core_cm3.h等必须Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/stm32f10x.h、system_stm32f10x.c必须Libraries/STM32F10x_StdPeriph_Driver/外设驱动源码src/和头文件inc/按需Project/STM32F10x_StdPeriph_Template/官方工程模板含main.c、中断处理参考Utilities/STM32_EVAL/官方评估板驱动一般用不上可删我一般会把Libraries整个拷到工程目录下Project里的模板只用来对照启动文件和中断向量表的写法不直接拿来编译。这样工程目录干净换芯片型号时只改宏定义和启动文件不用动库本身。2.3 工具链版本选择Keil MDK 用哪个版本不翻车标准库 3.6.0 对编译器版本不挑但 Keil MDK 从 5.30 之后默认的 ARM Compiler 6 对老库的汇编启动文件支持有变化。我实测下来MDK 5.28 到 5.36 配 ARM Compiler 5最稳启动文件startup_stm32f10x_md.s直接能编。如果只有新版 MDK需要在Options for Target → Target里把编译器切回Use default compiler version 5或者手动指定ARMCC路径。# 检查 Keil 安装目录下是否有 ARMCC 文件夹Compiler 5 的标志 ls C:/Keil_v5/ARM/ARMCC/bin/armcc.exe # 如果只有 ARMCLANG说明默认是 Compiler 6需要单独装 Legacy Support上面这条命令用来确认编译器版本。ARMCC是 Compiler 5 的可执行文件ARMCLANG是 Compiler 6。标准库 3.6.0 的启动文件里用了AREA、DCD这类 ARM 汇编伪指令Compiler 6 虽然兼容大部分但个别分散加载文件会报错。我一般直接装 Keil 的 Legacy Support 包省得改启动文件。3. 工程搭建从零建一个能编译的 STM32F10x 标准库工程3.1 新建工程与芯片型号选择打开 Keil MDKProject → New uVision Project选一个空目录芯片型号选STMicroelectronics → STM32F103C8如果是其他容量按实际选比如STM32F103ZE。弹窗问是否复制Startup文件时选否因为我们要用标准库自带的启动文件不用 Keil 的。建完工程后目录树里只有一个Target 1下面空荡荡。接下来手动建分组右键Target 1 → Manage Project Items建这几个组Startup放启动文件CMSIS放内核和系统文件StdPeriph_Driver放外设驱动User放main.c、中断处理、配置文件分组名随意但建议按这个来后面换芯片时一眼能看出哪个组要动。3.2 添加文件哪些 .c 必须加哪些可以不加往各组里加文件时最容易漏的是system_stm32f10x.c和stm32f10x_it.c。我列一下最小系统的文件清单# Startup 组根据芯片容量选一个 Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/startup/arm/startup_stm32f10x_md.s # CMSIS 组 Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/system_stm32f10x.c Libraries/CMSIS/CM3/CoreSupport/core_cm3.c # StdPeriph_Driver 组按需加这里以 GPIO、USART、RCC 为例 Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_gpio.c Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_usart.c Libraries/STM32F10x_StdPeriph_Driver/src/stm32f10x_rcc.c # User 组 Project/STM32F10x_StdPeriph_Template/stm32f10x_it.c # main.c 自己新建启动文件的选择看芯片容量md是中容量64KB/128KB Flashhd是大容量256KB以上ld是小容量32KB以下。选错了会在链接阶段报No section matches selector或者中断向量表对不上程序跑飞。core_cm3.c在新版库里其实可以不加因为core_cm3.h里已经用__INLINE内联了大部分函数但加上也不影响我习惯留着。3.3 头文件路径与宏定义两个必须配的地方文件加完后点Options for Target → C/C在Include Paths里加这几条.\Libraries\CMSIS\CM3\CoreSupport .\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x .\Libraries\STM32F10x_StdPeriph_Driver\inc .\User然后在Define框里填两个宏USE_STDPERIPH_DRIVER, STM32F10X_MDUSE_STDPERIPH_DRIVER是告诉stm32f10x.h去包含stm32f10x_conf.h不加的话标准库的外设函数声明不会展开。STM32F10X_MD是芯片密度定义必须和启动文件匹配。如果是大容量芯片改成STM32F10X_HD小容量改STM32F10X_LD。注意这两个宏之间用英文逗号分隔不要用中文逗号否则 Keil 会把它当成一个整体宏编译时报identifier USE_STDPERIPH_DRIVER, STM32F10X_MD is undefined。3.4 时钟配置system_stm32f10x.c 里改哪一行标准库默认用外部 8MHz 晶振PLL 倍频到 72MHz。如果你板子上是 12MHz 晶振或者用内部 HSI需要改system_stm32f10x.c里的SetSysClockTo72()函数。我一般不动这个文件而是在main.c开头调用SystemInit()后用RCC_GetClocksFreq()读一下实际频率确认时钟树对了再往下跑。#include stm32f10x.h #include stm32f10x_rcc.h int main(void) { SystemInit(); // 初始化时钟默认 72MHz RCC_ClocksTypeDef clocks; RCC_GetClocksFreq(clocks); // 如果 clocks.SYSCLK_Frequency 不是 72000000说明晶振或 PLL 配置有问题 while (1) { // 主循环 } }SystemInit()在启动文件里被Reset_Handler调用执行的是system_stm32f10x.c里的时钟初始化。RCC_GetClocksFreq()把当前各总线频率填进结构体调试时在 Watch 窗口看clocks.SYSCLK_Frequency最直接。如果读出来是 8000000说明外部晶振没起振程序自动切回了 HSI。4. 外设驱动配置GPIO、USART 和中断的落地写法4.1 GPIO 初始化结构体里每个成员的含义标准库的 GPIO 初始化靠GPIO_InitTypeDef结构体填完传给GPIO_Init()。以点亮 PC13 的 LED 为例GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); // 开 GPIOC 时钟 gpio.GPIO_Pin GPIO_Pin_13; gpio.GPIO_Speed GPIO_Speed_50MHz; // 输出速度LED 用 2MHz 也行 gpio.GPIO_Mode GPIO_Mode_Out_PP; // 推挽输出 GPIO_Init(GPIOC, gpio); GPIO_SetBits(GPIOC, GPIO_Pin_13); // 输出高电平灭灯取决于硬件接法RCC_APB2PeriphClockCmd必须放在GPIO_Init之前否则寄存器写不进去现象就是“程序在跑但引脚没反应”。GPIO_Speed只在输出模式下有意义输入模式下随便填。GPIO_Mode常用值GPIO_Mode_Out_PP推挽输出、GPIO_Mode_IPU上拉输入、GPIO_Mode_AIN模拟输入。我见过有人把 LED 配成GPIO_Mode_IPU然后纳闷为什么灯不亮——模式选错了引脚根本没往外驱动。4.2 USART 配置波特率算不对的排查思路串口是调试阶段最重要的外设。标准库配 USART1 的代码如下USART_InitTypeDef usart; GPIO_InitTypeDef gpio; // PA9 TX, PA10 RX RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); gpio.GPIO_Pin GPIO_Pin_9; gpio.GPIO_Mode GPIO_Mode_AF_PP; // 复用推挽 gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); gpio.GPIO_Pin GPIO_Pin_10; gpio.GPIO_Mode GPIO_Mode_IN_FLOATING; // 浮空输入 GPIO_Init(GPIOA, gpio); usart.USART_BaudRate 115200; usart.USART_WordLength USART_WordLength_8b; usart.USART_StopBits USART_StopBits_1; usart.USART_Parity USART_Parity_No; usart.USART_HardwareFlowControl USART_HardwareFlowControl_None; usart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, usart); USART_Cmd(USART1, ENABLE);TX 引脚必须配成GPIO_Mode_AF_PPRX 配成GPIO_Mode_IN_FLOATING这是 F1 系列复用功能的固定要求。波特率算不对时先确认SystemCoreClock是不是 72000000再看RCC_GetClocksFreq()里PCLK2_Frequency的值。USART1 挂在 APB2 上如果 APB2 分频不是 1USART_Init内部算出来的分频系数会偏。我一般把SystemCoreClock在调试时打印出来确认是 72M 再往下查。4.3 中断配置NVIC 优先级分组别乱设用中断收串口数据时NVIC 配置容易出问题。标准库的写法NVIC_InitTypeDef nvic; NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); // 2 位抢占2 位响应 nvic.NVIC_IRQChannel USART1_IRQn; nvic.NVIC_IRQChannelPreemptionPriority 1; nvic.NVIC_IRQChannelSubPriority 1; nvic.NVIC_IRQChannelCmd ENABLE; NVIC_Init(nvic); USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); // 开接收中断NVIC_PriorityGroupConfig整个工程调一次就行别在多个文件里重复调否则后面的会覆盖前面的分组设置。抢占优先级高的可以打断低的响应优先级只在同抢占级下比较。如果中断进不去先查USART_ITConfig有没有开对应的中断源再查NVIC_IRQChannelCmd是不是ENABLE最后看stm32f10x_it.c里有没有写USART1_IRQHandler。5. 避坑与排查标准库 3.6.0 最常见的五个翻车现场5.1 编译报 “Please select first the target STM32F10x device”现象编译时stm32f10x.h里报错提示没有定义目标芯片。原因Define里漏了STM32F10X_MD或写成了STM32F10X_MD带空格。解决在Options for Target → C/C → Define里补上注意逗号后不要有空格写成USE_STDPERIPH_DRIVER,STM32F10X_MD。5.2 程序下载后不运行调试器停在 HardFault现象Keil 下载成功但点运行后 PC 指针跳到HardFault_Handler。原因启动文件和芯片容量不匹配中断向量表偏移错了或者system_stm32f10x.c里外部晶振频率和实际不符PLL 锁不住。解决确认启动文件后缀md/hd/ld和Define里的密度宏一致用示波器或万用表量晶振引脚确认起振临时把SetSysClockTo72()改成SetSysClockToHSI()排除晶振问题。5.3 串口输出乱码现象串口助手收到一堆乱码或者偶尔对几个字符。原因波特率不匹配、时钟频率不对、或者 TX/RX 接反。解决先确认串口助手波特率和代码里一致再确认SystemCoreClock是 72M最后交换 TX/RX 线序。我遇到过一块板子晶振是 12M 但代码按 8M 算PLL 倍频后主频变成 108M串口分频全乱改HSE_VALUE宏为12000000就好了。5.4 外设初始化后没反应现象GPIO 不输出、USART 不发数据、定时器不计数。原因外设时钟没开或者开了但开错了总线APB1/APB2。解决查RCC_APB1PeriphClockCmd和RCC_APB2PeriphClockCmd的参数。GPIO 全在 APB2USART1 在 APB2USART2/3 在 APB1TIM2~7 在 APB1TIM1/8 在 APB2。开错总线寄存器写不进去现象就是“代码在跑但外设不动”。5.5 中断服务函数写了但进不去现象stm32f10x_it.c里写了USART1_IRQHandler但断点不命中。原因中断向量表里的函数名和启动文件里的弱定义对不上或者 NVIC 没使能。解决确认函数名拼写和启动文件里DCD USART1_IRQHandler一致确认NVIC_Init里NVIC_IRQChannelCmd ENABLE确认USART_ITConfig开了对应中断源。如果用了USE_STDPERIPH_DRIVERstm32f10x_it.c里的函数名必须和startup_stm32f10x_md.s里的向量表完全一致大小写都不能错。6. 装完怎么验证从串口打印到 LED 闪烁的完整检查链环境搭完别急着写业务代码先跑一个最小验证程序把时钟、GPIO、串口、中断四条链路都过一遍。我一般按这个顺序来第一步确认时钟。在main()开头调用SystemInit()后用RCC_GetClocksFreq()读频率通过串口打印出来。如果串口还没通就点灯——用RCC_GetClocksFreq()的结果去算一个精确的软件延时闪灯频率对了说明时钟基本对。第二步验证 GPIO。写一个最简单的闪灯程序不调任何库函数直接操作GPIOB-ODR寄存器翻转。如果寄存器操作能亮但库函数不亮说明库文件没加对或者头文件路径有问题。第三步打通串口。用USART_SendData()发一个固定字符串串口助手收到就说明时钟、GPIO 复用、USART 配置全对。收不到就按第 5 章的排查顺序走一遍。第四步验证中断。开 USART1 接收中断发一个字符在USART1_IRQHandler里翻转另一个 LED。中断能进说明 NVIC 和向量表都对。下面这个验证程序把四步串在一起可以直接抄#include stm32f10x.h #include stm32f10x_rcc.h #include stm32f10x_gpio.h #include stm32f10x_usart.h void Delay(__IO uint32_t n) { while (n--); } int main(void) { // 1. 时钟验证 SystemInit(); RCC_ClocksTypeDef clocks; RCC_GetClocksFreq(clocks); // 2. GPIO 初始化PC13 推挽输出 GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); gpio.GPIO_Pin GPIO_Pin_13; gpio.GPIO_Speed GPIO_Speed_2MHz; gpio.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOC, gpio); // 3. USART1 初始化PA9/PA10115200 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); gpio.GPIO_Pin GPIO_Pin_9; gpio.GPIO_Mode GPIO_Mode_AF_PP; gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); gpio.GPIO_Pin GPIO_Pin_10; gpio.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, gpio); USART_InitTypeDef usart; usart.USART_BaudRate 115200; usart.USART_WordLength USART_WordLength_8b; usart.USART_StopBits USART_StopBits_1; usart.USART_Parity USART_Parity_No; usart.USART_HardwareFlowControl USART_HardwareFlowControl_None; usart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, usart); USART_Cmd(USART1, ENABLE); // 4. 打印时钟频率 char buf[64]; int len 0; uint32_t f clocks.SYSCLK_Frequency / 1000000; buf[len] S; buf[len] Y; buf[len] S; buf[len] :; buf[len] (f / 10) 0; buf[len] (f % 10) 0; buf[len] M; buf[len] \r; buf[len] \n; for (int i 0; i len; i) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, buf[i]); } // 5. 主循环闪灯 while (1) { GPIO_SetBits(GPIOC, GPIO_Pin_13); Delay(7200000); // 约 100ms 72MHz GPIO_ResetBits(GPIOC, GPIO_Pin_13); Delay(7200000); } }这段代码跑通的标准是串口助手收到SYS:72M同时 PC13 上的 LED 以大约 5Hz 的频率闪烁。如果串口收到的是SYS:08M说明外部晶振没起振程序跑在 HSI 上需要检查晶振电路和HSE_VALUE宏。如果串口没输出但灯在闪说明 GPIO 和时钟没问题问题在 USART 配置或接线。如果灯也不闪回到第 5 章从启动文件和宏定义开始查。从那以后我每次搭标准库工程都强制先跑一遍这个四步验证链确认时钟、GPIO、串口、中断全通了再写业务代码。这套流程帮我省掉了至少几十次“编译通过但跑不起来”的无效调试。希望帮到你。本文还有配套的精品资源点击获取
