尧图网页设计 
1. 项目概述从零搭建你的第一个STM32工程很多刚接触STM32的朋友拿到开发板后最头疼的第一件事往往不是写代码而是怎么把开发环境搭起来怎么把第一个能点灯的工程文件建好。网上的教程要么太老用的还是Keil4或者过时的库文件要么太简略跳过了很多关键步骤导致新手照着做总是编译报错最后卡在“一堆红色错误”的界面不知所措。今天我就以最经典的STM32F103C8T6也就是常说的“蓝桥杯”或“最小系统板”核心芯片为例手把手带你用Keil5 MDK从空白文件夹开始一步步构建一个结构清晰、可移植性强的标准工程模板。这个模板不仅这次能用以后你做任何基于标准库的STM32F103项目都可以直接复制过去修改省去重复搭建的麻烦。2. 工程整体设计与目录结构规划在动手敲击任何代码或点击Keil的按钮之前花几分钟规划好工程的目录结构是区分“业余玩玩”和“专业开发”的第一个好习惯。一个混乱的工程后期添加文件、更换库版本、与他人协作时会变成一场灾难。2.1 为什么需要清晰的目录结构想象一下你的电脑桌面如果所有文件——文档、图片、软件安装包——都胡乱堆在一起找一个特定的文件有多困难。STM32工程也是如此。一个典型的工程会包含芯片厂商提供的标准外设库文件如STM32F10x_StdPeriph_Lib这是最底层、最核心的驱动代码负责操作芯片的寄存器。你自己编写的应用程序代码实现具体业务逻辑比如控制LED、读取传感器、处理通信协议。启动文件一段用汇编写的代码是芯片上电后运行的第一段程序负责初始化堆栈、设置中断向量表等“脏活累活”。链接脚本、工程配置文件告诉编译器代码放在芯片Flash的哪个位置变量放在RAM的哪个位置。如果把这些都混在同一个文件夹里不出三天你自己都分不清哪个文件是干什么的。清晰的目录结构能让逻辑一目了然方便管理也便于使用版本控制工具如Git进行管理。2.2 推荐的工程目录结构我建议在硬盘上比如D:\STM32_Projects创建一个名为Template_STM32F103的文件夹作为工程根目录。然后在里面创建如下子文件夹Template_STM32F103/ ├── Project/ # 存放Keil工程文件 (.uvprojx) 和输出文件 (.axf, .hex) │ ├── Listings/ # 编译器生成的列表文件可删 │ └── Objects/ # 编译器生成的目标文件 (.o) 和可执行文件 (.axf, .hex) ├── Libraries/ # 存放芯片相关的库文件 │ ├── CMSIS/ # Cortex微控制器软件接口标准文件内核相关 │ └── STM32F10x_StdPeriph_Driver/ # ST官方标准外设驱动库 ├── User/ # 存放用户自己的代码 │ ├── main.c # 主函数 │ ├── stm32f10x_it.c # 中断服务函数文件 │ ├── stm32f10x_conf.h # 库配置文件 │ └── system_stm32f10x.c # 系统时钟初始化文件 └── README.md # 工程说明文档可选但好习惯这样规划的好处是Libraries文件夹里的内容是“只读”的是ST官方提供的我们一般不会修改。User文件夹里是我们自己的“创作空间”。Project文件夹是Keil的“工作区”。三者分离互不干扰。当你需要升级库版本时直接替换Libraries文件夹即可当你需要备份自己的代码时拷贝User文件夹就行。注意很多新手教程会让大家从ST官网下载整个标准库包STM32F10x_StdPeriph_Lib然后从里面复制文件。我强烈建议你直接使用我已经筛选、整理好的最小必要文件集。官网的库包包含了很多针对不同型号、不同评估板的例子和冗余文件对于新手来说信息过载容易混淆。我会在后续提供这些核心文件的获取和放置方法。3. 核心文件准备与解析搭建工程本质上就是把正确的文件放到正确的位置并告诉Keil如何找到它们。下面我们逐一准备这些核心文件。3.1 获取标准外设库StdPeriph LibraryST官方标准库虽然已停止更新转向HAL库和LL库但对于学习STM32F103和进行稳定产品开发来说它依然是经典且资源丰富的选择。你不需要下载整个几百MB的库包。你需要从库包中提取的核心文件包括启动文件位于Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm。对于STM32F103C8T6中等容量你需要的是startup_stm32f10x_md.smd代表Medium Density。这个文件定义了中断向量表和最基本的初始化流程。CMSIS核心文件Libraries\CMSIS\CM3\CoreSupport下的core_cm3.c和core_cm3.h。这是ARM Cortex-M3内核的通用接口文件。Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下的system_stm32f10x.c和system_stm32f10x.h。这里面包含了非常重要的SystemInit()函数用于初始化系统时钟默认是HSI 8MHz。标准外设驱动源码Libraries\STM32F10x_StdPeriph_Driver\src下的所有.c文件。如stm32f10x_gpio.c,stm32f10x_rcc.c等。我们不会一次性全部添加进工程而是根据需要用哪个添加哪个以减少编译时间。标准外设驱动头文件Libraries\STM32F10x_StdPeriph_Driver\inc下的所有.h文件。关键头文件Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下的stm32f10x.h。这是整个芯片的“总头文件”包含了所有寄存器定义和基础数据类型。Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下的stm32f10x_conf.h。这是库的“配置文件”通过注释或取消注释里面的宏定义来决定编译时包含哪些外设驱动。同一个目录下的stm32f10x_it.h和stm32f10x_it.c模板。用于编写中断服务函数。实操心得我通常会准备一个“标准库最小文件包”里面只包含上述必要的文件剔除了所有例子和文档体积不到10MB。对于新手我强烈建议你直接使用这样的纯净包开始避免在文件海洋中迷失。你可以通过一些开源社区或资源站找到这类整理好的资源包。3.2 创建用户代码文件在User文件夹下我们需要创建或复制以下文件main.c: 工程的入口你的主循环就在这里。stm32f10x_it.c: 从标准库包中复制过来存放中断服务函数。例如SysTick定时器中断、USART中断等都会在这里添加代码。stm32f10x_conf.h: 从标准库包中复制到User目录。重要我们后续会修改这个文件所以必须放在User目录下与库文件原路径分离。system_stm32f10x.c: 从标准库包中复制到User目录。我们可能为了修改时钟配置而改动它。关键步骤将stm32f10x_conf.h和system_stm32f10x.c复制到User目录意味着我们拥有了对这些文件的自定义控制权而不会污染原始的库文件。这是一种良好的工程实践。4. 使用Keil5创建工程与详细配置现在我们打开Keil5 MDK开始真正的工程创建。4.1 新建工程与选择芯片型号启动Keil5点击菜单栏的Project - New uVision Project...。在弹出的对话框中导航到你之前创建的Template_STM32F103\Project目录。在“文件名”处输入你的工程名例如MySTM32Template然后点击保存。选择芯片型号这会弹出一个庞大的设备选择窗口。在搜索框输入STM32F103C8列表中会高亮显示STM32F103C8。注意这里要选择STM32F103C8而不是STM32F103C8Tx或STM32F103C8T6。Keil的数据库通常只到系列号。选中它点击OK。管理运行时环境RTE接着会弹出“Manage Run-Time Environment”窗口。对于使用标准库的我们这个窗口直接点击Cancel取消即可这是Keil5用于管理软件包如CMSIS、HAL库的界面我们手动管理文件更清晰。踩坑提示很多新手在这里会误操作添加了软件包导致后续出现头文件路径冲突、重复定义等问题。记住纯手动搭建标准库工程一律取消RTE窗口。4.2 添加文件到工程组工程创建好后左侧Project窗口是空的。我们需要创建逻辑分组并添加文件。在Project窗口的Target 1上右键选择Manage Project Items...。在Project Items标签页我们先创建分组类似文件夹点击Groups区域下方的New (Insert)按钮创建以下分组Startup(存放启动文件)CMSIS(存放内核相关文件)StdPeriph_Driver(存放外设驱动源文件)User(存放用户代码)为每个分组添加文件选中Startup分组在右侧Files区域点击Add Files导航到Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm选择startup_stm32f10x_md.s点击Add然后Close。选中CMSIS分组添加文件Libraries\CMSIS\CM3\CoreSupport\core_cm3.cUser\system_stm32f10x.c(注意这里添加的是我们复制到User目录下的那个)选中StdPeriph_Driver分组我们暂时只添加最常用的两个驱动。导航到Libraries\STM32F10x_StdPeriph_Driver\src按住Ctrl键选择stm32f10x_gpio.cstm32f10x_rcc.c点击Add。其他外设驱动如usart.c,spi.c等等用到时再添加。选中User分组添加文件User\main.cUser\stm32f10x_it.c添加完成后点击OK关闭对话框。现在你的Project窗口应该有了清晰的分组和文件。4.3 配置头文件包含路径Include Paths这是最关键的一步告诉编译器去哪里找.h头文件。如果路径不对会出现“stm32f10x.hfile not found”之类的致命错误。点击工具栏的魔术棒按钮Options for Target或者右键Target 1选择Options for Target...。在弹出的对话框中选择C/C选项卡。找到Include Paths一栏点击末尾的...按钮。点击右上角的New (Insert)按钮一个文件夹带*号图标然后点击...来浏览添加路径。需要添加的路径有../Libraries/CMSIS/CM3/CoreSupport(为了找到core_cm3.h)../Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x(为了找到stm32f10x.h)../Libraries/STM32F10x_StdPeriph_Driver/inc(为了找到所有外设驱动头文件如stm32f10x_gpio.h)../User(为了找到我们自己目录下的stm32f10x_conf.h和stm32f10x_it.h)注意这里的../表示上一级目录因为我们的工程文件在Project文件夹里而库文件在平行的Libraries文件夹里。务必根据你的实际目录层级调整。添加完所有路径后点击OK。4.4 配置全局宏定义Define同样在C/C选项卡找到Define输入框。这里需要输入预处理器宏用于条件编译。 对于STM32F103标准库通常需要添加USE_STDPERIPH_DRIVER, STM32F10X_MDUSE_STDPERIPH_DRIVER这个宏告诉stm32f10x.h去包含stm32f10x_conf.h配置文件。没有它外设驱动相关的声明就不会被引入。STM32F10X_MD这个宏定义了芯片的密度容量。对于STM32F103C8T664KB Flash20KB RAM属于中等容量Medium Density所以是MD。如果是小容量如F103C6则是LD大容量如F103ZE则是HD。这个宏会影响启动文件、头文件中的一些条件编译必须与使用的启动文件md.s和芯片型号匹配否则会导致内存映射错误程序无法运行。4.5 配置调试与下载工具在Debug选项卡你可以选择仿真工具。如果你使用ST-LINK在Use下拉框中选择ST-Link Debugger然后点击旁边的Settings。在Debug子选项卡确认Port是SWSerial Wire即SWD接口。在Flash Download子选项卡点击Add为你的芯片添加Flash编程算法。对于STM32F103C8选择STM32F10x Medium-density Flash。这一步至关重要否则无法将程序下载到芯片的Flash中。4.6 配置输出Hex文件在Output选项卡勾选Create HEX File。这样编译后会生成一个.hex文件这是大多数下载工具如ST-Link Utility, FlyMCU都能识别的烧录文件格式。你可以点击Select Folder for Objects...将输出目录指定到我们之前创建的Project\Objects文件夹保持工程整洁。5. 编写用户代码与工程测试环境配置好了我们来写点最简单的代码测试整个工程框架是否工作。5.1 修改配置文件 (stm32f10x_conf.h)打开User目录下的stm32f10x_conf.h。这个文件里所有外设驱动的头文件包含都被注释掉了。我们需要用到哪个外设就取消哪行的注释。 对于我们即将进行的点灯测试用到GPIO和系统时钟初始化用到RCC需要确保以下两行没有被注释// #include stm32f10x_adc.h // #include stm32f10x_bkp.h ... #include stm32f10x_gpio.h // 确保这行存在且未被注释 #include stm32f10x_rcc.h // 确保这行存在且未被注释 ... // #include stm32f10x_wwdg.h同时检查文件开头附近确保#define USE_STDPERIPH_DRIVER这一行是存在的通常它会在别处定义这里检查一下即可。5.2 编写主函数 (main.c)清空或编写User/main.c文件内容如下#include stm32f10x.h // 这是必须的包含了所有寄存器和外设定义 /** * brief 简单的延时函数循环延时不精确 * param count: 延时循环次数 * retval None */ void Delay(__IO uint32_t nCount) { for(; nCount ! 0; nCount--); } /** * brief 主函数 * param None * retval None */ int main(void) { /* 初始化系统时钟 - 默认使用内部HSI 8MHz */ SystemInit(); /* 开启GPIOB端口的时钟 */ // 对于STM32任何外设使用前必须先开启其时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); /* 配置PB0引脚为推挽输出模式 */ GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; // 选择引脚0 GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; // 推挽输出模式 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; // 输出速度50MHz GPIO_Init(GPIOB, GPIO_InitStructure); // 应用配置到GPIOB端口 /* 主循环 */ while (1) { GPIO_SetBits(GPIOB, GPIO_Pin_0); // 将PB0置高电平LED灭如果LED阴极接在PB0 Delay(5000000); // 延时 GPIO_ResetBits(GPIOB, GPIO_Pin_0); // 将PB0置低电平LED亮 Delay(5000000); // 延时 } } /** * brief 系统时钟配置错误处理函数弱定义可重写 * param None * retval None */ void assert_failed(uint8_t* file, uint32_t line) { /* 用户可以在此添加自己的错误处理代码例如让某个LED闪烁 */ while (1) { } }代码解析SystemInit()在system_stm32f10x.c中定义默认将系统时钟配置为HSI 8MHz。如果你想使用外部晶振HSE并倍频到72MHz需要修改这个函数。RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE)STM32的省电设计每个外设的时钟默认是关闭的使用前必须开启。GPIOB挂在APB2总线上。GPIO_InitTypeDef这是一个结构体用于配置GPIO的模式、速度等参数。这种“初始化结构体初始化函数”的模式是标准库的典型风格。GPIO_Mode_Out_PP推挽输出模式可以提供较强的驱动能力高电平输出接近VCC低电平输出接近GND适合驱动LED。assert_failed这是一个“弱定义”函数。如果在stm32f10x_conf.h中定义了USE_FULL_ASSERT并且库函数内部的参数检查失败断言失败就会调用这个函数。我们这里提供了一个空实现防止链接错误。5.3 编译与下载编译点击工具栏的Build按钮或按F7。如果前面所有步骤都正确你会在下方的Build Output窗口看到linking... Program Size: Codexxx RO-dataxxx RW-dataxxx ZI-dataxxx .\Objects\MySTM32Template.axf - 0 Error(s), 0 Warning(s).0 Error(s)是目标。可能会有几个警告通常可以暂时忽略。下载将你的STM32开发板通过ST-LINK连接到电脑并确保供电。点击工具栏的Load按钮或按F8。如果Flash下载算法配置正确你会看到进度条最后显示Flash Load finished。观察结果如果开发板上PB0引脚通常是板载LED的连接引脚接有LED此时应该能看到LED在闪烁。恭喜你你的第一个STM32工程成功运行了6. 常见问题排查与进阶技巧即使按照步骤操作也难免会遇到问题。这里汇总一些常见坑点。6.1 编译错误排查表错误信息可能原因解决方案fatal error: stm32f10x.h: No such file or directory头文件包含路径错误。检查Options for Target - C/C - Include Paths确保路径指向正确的文件夹且使用了正确的相对路径../。error: #5: cannot open source input file core_cm3.hCMSIS核心头文件路径缺失。在包含路径中添加../Libraries/CMSIS/CM3/CoreSupport。undefined symbol SystemInit (referred from startup_stm32f10x_md.o)链接时找不到SystemInit函数。确保system_stm32f10x.c文件已正确添加到CMSIS分组中并被编译。warning: #223-D: function assert_failed declared implicitly未定义assert_failed函数。在main.c或单独的文件中实现这个函数如上例所示或者确保USE_FULL_ASSERT宏没有被定义。大量identifier “xxx” is undefined错误全局宏定义STM32F10X_MD未设置或错误。检查Options for Target - C/C - Define确保正确添加了STM32F10X_MD根据你的芯片选LD, MD, HD。程序下载后不运行LED不亮1. 启动文件与芯片容量不匹配。2. 系统时钟配置错误。3. GPIO时钟未开启或配置错误。4. 硬件连接问题LED接错引脚、共阳/共阴极接反。1. 确认启动文件md.s与宏定义STM32F10X_MD匹配。2. 单步调试检查SystemInit()后系统时钟变量SystemCoreClock的值。3. 使用调试器查看GPIOB相关寄存器RCC_APB2ENR, GPIOB_CRL是否被正确配置。4. 用万用表测量引脚电平或写一个简单的程序让所有GPIO口轮流输出高/低电平测试。6.2 进阶配置使用外部晶振HSE并配置系统时钟为72MHz默认的8MHz HSI时钟性能有限。大多数STM32F103开发板都外接了8MHz晶振我们可以将其倍频到72MHz。修改system_stm32f10x.c找到SystemInit()函数以及文件开头的#define部分。通常我们需要修改的是SetSysClock()函数。但更规范的做法是不直接修改库文件而是在main()函数开头调用自己的时钟配置函数。不过对于学习我们可以直接修改库文件中的SetSysClock()函数。找到#if defined (STM32F10X_LD_VL) ...这一大段条件编译代码找到对应STM32F10X_MD或STM32F10X_HD的部分确保其调用了SetSysClockTo72()函数。通常标准库的默认实现已经考虑了这一点你需要检查的是确保#define SYSCLK_FREQ_72MHz 72000000被定义。在SetSysClock()函数中找到#ifdef SYSCLK_FREQ_72MHz ... #endif块并确保它最终调用了SetSysClockTo72()。注意直接修改库文件不利于工程迁移。更好的做法是复制system_stm32f10x.c到User目录并修改复制的版本同时在工程中替换原文件。或者在main()中SystemInit()之后再调用RCC库函数重新配置时钟。一个更清晰的、在main中配置时钟的示例void RCC_HSE_Config(void) { ErrorStatus HSEStartUpStatus; /* 复位RCC时钟配置为默认状态对于调试很重要 */ RCC_DeInit(); /* 开启HSE */ RCC_HSEConfig(RCC_HSE_ON); /* 等待HSE稳定 */ HSEStartUpStatus RCC_WaitForHSEStartUp(); if(HSEStartUpStatus SUCCESS) { /* 设置HCLKAHB时钟 SYSCLK */ RCC_HCLKConfig(RCC_SYSCLK_Div1); /* 设置PCLK2APB2高速时钟 HCLK */ RCC_PCLK2Config(RCC_HCLK_Div1); /* 设置PCLK1APB1低速时钟 HCLK/2 (APB1最大36MHz) */ RCC_PCLK1Config(RCC_HCLK_Div2); /* 设置PLL时钟源为HSE 倍频系数为9 - 8MHz * 9 72MHz */ RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); /* 使能PLL */ RCC_PLLCmd(ENABLE); /* 等待PLL就绪 */ while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) RESET); /* 选择PLL作为系统时钟源 */ RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); /* 等待系统时钟源切换成功 */ while(RCC_GetSYSCLKSource() ! 0x08); } /* 使能外设时钟可选在用到时再开启也行 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); }然后在main()函数开头先调用SystemInit()它将时钟初始化为HSI 8MHz再调用RCC_HSE_Config()覆盖配置为72MHz。6.3 工程模板的维护与扩展当你成功创建了这个模板工程后如何用它开始新的项目复制整个工程文件夹将Template_STM32F103文件夹复制一份重命名为你的新项目名。修改工程名在Keil中通过Project - Manage - Project Items修改项目名称或者直接关闭Keil将Project文件夹下的.uvprojx文件重命名。清理中间文件删除Project\Listings和Project\Objects文件夹下的所有内容.uvprojx和.uvoptx除外。编写新代码在User\main.c中开始你的新应用并根据需要在stm32f10x_conf.h中使能新的外设头文件。在Keil工程中添加新的外设驱动源文件.c文件到StdPeriph_Driver分组。在User目录下创建新的.c/.h文件来模块化你的代码。最后一点心得搭建工程的过程看似繁琐但每一步都有其意义。理解目录结构、头文件路径、宏定义和启动文件的作用远比死记硬背步骤重要。这个自己搭建的模板就像你亲手打磨的一把顺手的工具以后无论遇到什么型号的STM32只要还使用标准库你都能快速地上手。遇到问题学会看编译错误信息学会使用调试器查看寄存器这些能力比单纯让LED闪烁更加宝贵。 STM32标准库工程搭建指南：从零构建可复用项目模板
1. 项目概述从零搭建你的第一个STM32工程很多刚接触STM32的朋友拿到开发板后最头疼的第一件事往往不是写代码而是怎么把开发环境搭起来怎么把第一个能点灯的工程文件建好。网上的教程要么太老用的还是Keil4或者过时的库文件要么太简略跳过了很多关键步骤导致新手照着做总是编译报错最后卡在“一堆红色错误”的界面不知所措。今天我就以最经典的STM32F103C8T6也就是常说的“蓝桥杯”或“最小系统板”核心芯片为例手把手带你用Keil5 MDK从空白文件夹开始一步步构建一个结构清晰、可移植性强的标准工程模板。这个模板不仅这次能用以后你做任何基于标准库的STM32F103项目都可以直接复制过去修改省去重复搭建的麻烦。2. 工程整体设计与目录结构规划在动手敲击任何代码或点击Keil的按钮之前花几分钟规划好工程的目录结构是区分“业余玩玩”和“专业开发”的第一个好习惯。一个混乱的工程后期添加文件、更换库版本、与他人协作时会变成一场灾难。2.1 为什么需要清晰的目录结构想象一下你的电脑桌面如果所有文件——文档、图片、软件安装包——都胡乱堆在一起找一个特定的文件有多困难。STM32工程也是如此。一个典型的工程会包含芯片厂商提供的标准外设库文件如STM32F10x_StdPeriph_Lib这是最底层、最核心的驱动代码负责操作芯片的寄存器。你自己编写的应用程序代码实现具体业务逻辑比如控制LED、读取传感器、处理通信协议。启动文件一段用汇编写的代码是芯片上电后运行的第一段程序负责初始化堆栈、设置中断向量表等“脏活累活”。链接脚本、工程配置文件告诉编译器代码放在芯片Flash的哪个位置变量放在RAM的哪个位置。如果把这些都混在同一个文件夹里不出三天你自己都分不清哪个文件是干什么的。清晰的目录结构能让逻辑一目了然方便管理也便于使用版本控制工具如Git进行管理。2.2 推荐的工程目录结构我建议在硬盘上比如D:\STM32_Projects创建一个名为Template_STM32F103的文件夹作为工程根目录。然后在里面创建如下子文件夹Template_STM32F103/ ├── Project/ # 存放Keil工程文件 (.uvprojx) 和输出文件 (.axf, .hex) │ ├── Listings/ # 编译器生成的列表文件可删 │ └── Objects/ # 编译器生成的目标文件 (.o) 和可执行文件 (.axf, .hex) ├── Libraries/ # 存放芯片相关的库文件 │ ├── CMSIS/ # Cortex微控制器软件接口标准文件内核相关 │ └── STM32F10x_StdPeriph_Driver/ # ST官方标准外设驱动库 ├── User/ # 存放用户自己的代码 │ ├── main.c # 主函数 │ ├── stm32f10x_it.c # 中断服务函数文件 │ ├── stm32f10x_conf.h # 库配置文件 │ └── system_stm32f10x.c # 系统时钟初始化文件 └── README.md # 工程说明文档可选但好习惯这样规划的好处是Libraries文件夹里的内容是“只读”的是ST官方提供的我们一般不会修改。User文件夹里是我们自己的“创作空间”。Project文件夹是Keil的“工作区”。三者分离互不干扰。当你需要升级库版本时直接替换Libraries文件夹即可当你需要备份自己的代码时拷贝User文件夹就行。注意很多新手教程会让大家从ST官网下载整个标准库包STM32F10x_StdPeriph_Lib然后从里面复制文件。我强烈建议你直接使用我已经筛选、整理好的最小必要文件集。官网的库包包含了很多针对不同型号、不同评估板的例子和冗余文件对于新手来说信息过载容易混淆。我会在后续提供这些核心文件的获取和放置方法。3. 核心文件准备与解析搭建工程本质上就是把正确的文件放到正确的位置并告诉Keil如何找到它们。下面我们逐一准备这些核心文件。3.1 获取标准外设库StdPeriph LibraryST官方标准库虽然已停止更新转向HAL库和LL库但对于学习STM32F103和进行稳定产品开发来说它依然是经典且资源丰富的选择。你不需要下载整个几百MB的库包。你需要从库包中提取的核心文件包括启动文件位于Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm。对于STM32F103C8T6中等容量你需要的是startup_stm32f10x_md.smd代表Medium Density。这个文件定义了中断向量表和最基本的初始化流程。CMSIS核心文件Libraries\CMSIS\CM3\CoreSupport下的core_cm3.c和core_cm3.h。这是ARM Cortex-M3内核的通用接口文件。Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下的system_stm32f10x.c和system_stm32f10x.h。这里面包含了非常重要的SystemInit()函数用于初始化系统时钟默认是HSI 8MHz。标准外设驱动源码Libraries\STM32F10x_StdPeriph_Driver\src下的所有.c文件。如stm32f10x_gpio.c,stm32f10x_rcc.c等。我们不会一次性全部添加进工程而是根据需要用哪个添加哪个以减少编译时间。标准外设驱动头文件Libraries\STM32F10x_StdPeriph_Driver\inc下的所有.h文件。关键头文件Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下的stm32f10x.h。这是整个芯片的“总头文件”包含了所有寄存器定义和基础数据类型。Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下的stm32f10x_conf.h。这是库的“配置文件”通过注释或取消注释里面的宏定义来决定编译时包含哪些外设驱动。同一个目录下的stm32f10x_it.h和stm32f10x_it.c模板。用于编写中断服务函数。实操心得我通常会准备一个“标准库最小文件包”里面只包含上述必要的文件剔除了所有例子和文档体积不到10MB。对于新手我强烈建议你直接使用这样的纯净包开始避免在文件海洋中迷失。你可以通过一些开源社区或资源站找到这类整理好的资源包。3.2 创建用户代码文件在User文件夹下我们需要创建或复制以下文件main.c: 工程的入口你的主循环就在这里。stm32f10x_it.c: 从标准库包中复制过来存放中断服务函数。例如SysTick定时器中断、USART中断等都会在这里添加代码。stm32f10x_conf.h: 从标准库包中复制到User目录。重要我们后续会修改这个文件所以必须放在User目录下与库文件原路径分离。system_stm32f10x.c: 从标准库包中复制到User目录。我们可能为了修改时钟配置而改动它。关键步骤将stm32f10x_conf.h和system_stm32f10x.c复制到User目录意味着我们拥有了对这些文件的自定义控制权而不会污染原始的库文件。这是一种良好的工程实践。4. 使用Keil5创建工程与详细配置现在我们打开Keil5 MDK开始真正的工程创建。4.1 新建工程与选择芯片型号启动Keil5点击菜单栏的Project - New uVision Project...。在弹出的对话框中导航到你之前创建的Template_STM32F103\Project目录。在“文件名”处输入你的工程名例如MySTM32Template然后点击保存。选择芯片型号这会弹出一个庞大的设备选择窗口。在搜索框输入STM32F103C8列表中会高亮显示STM32F103C8。注意这里要选择STM32F103C8而不是STM32F103C8Tx或STM32F103C8T6。Keil的数据库通常只到系列号。选中它点击OK。管理运行时环境RTE接着会弹出“Manage Run-Time Environment”窗口。对于使用标准库的我们这个窗口直接点击Cancel取消即可这是Keil5用于管理软件包如CMSIS、HAL库的界面我们手动管理文件更清晰。踩坑提示很多新手在这里会误操作添加了软件包导致后续出现头文件路径冲突、重复定义等问题。记住纯手动搭建标准库工程一律取消RTE窗口。4.2 添加文件到工程组工程创建好后左侧Project窗口是空的。我们需要创建逻辑分组并添加文件。在Project窗口的Target 1上右键选择Manage Project Items...。在Project Items标签页我们先创建分组类似文件夹点击Groups区域下方的New (Insert)按钮创建以下分组Startup(存放启动文件)CMSIS(存放内核相关文件)StdPeriph_Driver(存放外设驱动源文件)User(存放用户代码)为每个分组添加文件选中Startup分组在右侧Files区域点击Add Files导航到Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm选择startup_stm32f10x_md.s点击Add然后Close。选中CMSIS分组添加文件Libraries\CMSIS\CM3\CoreSupport\core_cm3.cUser\system_stm32f10x.c(注意这里添加的是我们复制到User目录下的那个)选中StdPeriph_Driver分组我们暂时只添加最常用的两个驱动。导航到Libraries\STM32F10x_StdPeriph_Driver\src按住Ctrl键选择stm32f10x_gpio.cstm32f10x_rcc.c点击Add。其他外设驱动如usart.c,spi.c等等用到时再添加。选中User分组添加文件User\main.cUser\stm32f10x_it.c添加完成后点击OK关闭对话框。现在你的Project窗口应该有了清晰的分组和文件。4.3 配置头文件包含路径Include Paths这是最关键的一步告诉编译器去哪里找.h头文件。如果路径不对会出现“stm32f10x.hfile not found”之类的致命错误。点击工具栏的魔术棒按钮Options for Target或者右键Target 1选择Options for Target...。在弹出的对话框中选择C/C选项卡。找到Include Paths一栏点击末尾的...按钮。点击右上角的New (Insert)按钮一个文件夹带*号图标然后点击...来浏览添加路径。需要添加的路径有../Libraries/CMSIS/CM3/CoreSupport(为了找到core_cm3.h)../Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x(为了找到stm32f10x.h)../Libraries/STM32F10x_StdPeriph_Driver/inc(为了找到所有外设驱动头文件如stm32f10x_gpio.h)../User(为了找到我们自己目录下的stm32f10x_conf.h和stm32f10x_it.h)注意这里的../表示上一级目录因为我们的工程文件在Project文件夹里而库文件在平行的Libraries文件夹里。务必根据你的实际目录层级调整。添加完所有路径后点击OK。4.4 配置全局宏定义Define同样在C/C选项卡找到Define输入框。这里需要输入预处理器宏用于条件编译。 对于STM32F103标准库通常需要添加USE_STDPERIPH_DRIVER, STM32F10X_MDUSE_STDPERIPH_DRIVER这个宏告诉stm32f10x.h去包含stm32f10x_conf.h配置文件。没有它外设驱动相关的声明就不会被引入。STM32F10X_MD这个宏定义了芯片的密度容量。对于STM32F103C8T664KB Flash20KB RAM属于中等容量Medium Density所以是MD。如果是小容量如F103C6则是LD大容量如F103ZE则是HD。这个宏会影响启动文件、头文件中的一些条件编译必须与使用的启动文件md.s和芯片型号匹配否则会导致内存映射错误程序无法运行。4.5 配置调试与下载工具在Debug选项卡你可以选择仿真工具。如果你使用ST-LINK在Use下拉框中选择ST-Link Debugger然后点击旁边的Settings。在Debug子选项卡确认Port是SWSerial Wire即SWD接口。在Flash Download子选项卡点击Add为你的芯片添加Flash编程算法。对于STM32F103C8选择STM32F10x Medium-density Flash。这一步至关重要否则无法将程序下载到芯片的Flash中。4.6 配置输出Hex文件在Output选项卡勾选Create HEX File。这样编译后会生成一个.hex文件这是大多数下载工具如ST-Link Utility, FlyMCU都能识别的烧录文件格式。你可以点击Select Folder for Objects...将输出目录指定到我们之前创建的Project\Objects文件夹保持工程整洁。5. 编写用户代码与工程测试环境配置好了我们来写点最简单的代码测试整个工程框架是否工作。5.1 修改配置文件 (stm32f10x_conf.h)打开User目录下的stm32f10x_conf.h。这个文件里所有外设驱动的头文件包含都被注释掉了。我们需要用到哪个外设就取消哪行的注释。 对于我们即将进行的点灯测试用到GPIO和系统时钟初始化用到RCC需要确保以下两行没有被注释// #include stm32f10x_adc.h // #include stm32f10x_bkp.h ... #include stm32f10x_gpio.h // 确保这行存在且未被注释 #include stm32f10x_rcc.h // 确保这行存在且未被注释 ... // #include stm32f10x_wwdg.h同时检查文件开头附近确保#define USE_STDPERIPH_DRIVER这一行是存在的通常它会在别处定义这里检查一下即可。5.2 编写主函数 (main.c)清空或编写User/main.c文件内容如下#include stm32f10x.h // 这是必须的包含了所有寄存器和外设定义 /** * brief 简单的延时函数循环延时不精确 * param count: 延时循环次数 * retval None */ void Delay(__IO uint32_t nCount) { for(; nCount ! 0; nCount--); } /** * brief 主函数 * param None * retval None */ int main(void) { /* 初始化系统时钟 - 默认使用内部HSI 8MHz */ SystemInit(); /* 开启GPIOB端口的时钟 */ // 对于STM32任何外设使用前必须先开启其时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); /* 配置PB0引脚为推挽输出模式 */ GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; // 选择引脚0 GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; // 推挽输出模式 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; // 输出速度50MHz GPIO_Init(GPIOB, GPIO_InitStructure); // 应用配置到GPIOB端口 /* 主循环 */ while (1) { GPIO_SetBits(GPIOB, GPIO_Pin_0); // 将PB0置高电平LED灭如果LED阴极接在PB0 Delay(5000000); // 延时 GPIO_ResetBits(GPIOB, GPIO_Pin_0); // 将PB0置低电平LED亮 Delay(5000000); // 延时 } } /** * brief 系统时钟配置错误处理函数弱定义可重写 * param None * retval None */ void assert_failed(uint8_t* file, uint32_t line) { /* 用户可以在此添加自己的错误处理代码例如让某个LED闪烁 */ while (1) { } }代码解析SystemInit()在system_stm32f10x.c中定义默认将系统时钟配置为HSI 8MHz。如果你想使用外部晶振HSE并倍频到72MHz需要修改这个函数。RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE)STM32的省电设计每个外设的时钟默认是关闭的使用前必须开启。GPIOB挂在APB2总线上。GPIO_InitTypeDef这是一个结构体用于配置GPIO的模式、速度等参数。这种“初始化结构体初始化函数”的模式是标准库的典型风格。GPIO_Mode_Out_PP推挽输出模式可以提供较强的驱动能力高电平输出接近VCC低电平输出接近GND适合驱动LED。assert_failed这是一个“弱定义”函数。如果在stm32f10x_conf.h中定义了USE_FULL_ASSERT并且库函数内部的参数检查失败断言失败就会调用这个函数。我们这里提供了一个空实现防止链接错误。5.3 编译与下载编译点击工具栏的Build按钮或按F7。如果前面所有步骤都正确你会在下方的Build Output窗口看到linking... Program Size: Codexxx RO-dataxxx RW-dataxxx ZI-dataxxx .\Objects\MySTM32Template.axf - 0 Error(s), 0 Warning(s).0 Error(s)是目标。可能会有几个警告通常可以暂时忽略。下载将你的STM32开发板通过ST-LINK连接到电脑并确保供电。点击工具栏的Load按钮或按F8。如果Flash下载算法配置正确你会看到进度条最后显示Flash Load finished。观察结果如果开发板上PB0引脚通常是板载LED的连接引脚接有LED此时应该能看到LED在闪烁。恭喜你你的第一个STM32工程成功运行了6. 常见问题排查与进阶技巧即使按照步骤操作也难免会遇到问题。这里汇总一些常见坑点。6.1 编译错误排查表错误信息可能原因解决方案fatal error: stm32f10x.h: No such file or directory头文件包含路径错误。检查Options for Target - C/C - Include Paths确保路径指向正确的文件夹且使用了正确的相对路径../。error: #5: cannot open source input file core_cm3.hCMSIS核心头文件路径缺失。在包含路径中添加../Libraries/CMSIS/CM3/CoreSupport。undefined symbol SystemInit (referred from startup_stm32f10x_md.o)链接时找不到SystemInit函数。确保system_stm32f10x.c文件已正确添加到CMSIS分组中并被编译。warning: #223-D: function assert_failed declared implicitly未定义assert_failed函数。在main.c或单独的文件中实现这个函数如上例所示或者确保USE_FULL_ASSERT宏没有被定义。大量identifier “xxx” is undefined错误全局宏定义STM32F10X_MD未设置或错误。检查Options for Target - C/C - Define确保正确添加了STM32F10X_MD根据你的芯片选LD, MD, HD。程序下载后不运行LED不亮1. 启动文件与芯片容量不匹配。2. 系统时钟配置错误。3. GPIO时钟未开启或配置错误。4. 硬件连接问题LED接错引脚、共阳/共阴极接反。1. 确认启动文件md.s与宏定义STM32F10X_MD匹配。2. 单步调试检查SystemInit()后系统时钟变量SystemCoreClock的值。3. 使用调试器查看GPIOB相关寄存器RCC_APB2ENR, GPIOB_CRL是否被正确配置。4. 用万用表测量引脚电平或写一个简单的程序让所有GPIO口轮流输出高/低电平测试。6.2 进阶配置使用外部晶振HSE并配置系统时钟为72MHz默认的8MHz HSI时钟性能有限。大多数STM32F103开发板都外接了8MHz晶振我们可以将其倍频到72MHz。修改system_stm32f10x.c找到SystemInit()函数以及文件开头的#define部分。通常我们需要修改的是SetSysClock()函数。但更规范的做法是不直接修改库文件而是在main()函数开头调用自己的时钟配置函数。不过对于学习我们可以直接修改库文件中的SetSysClock()函数。找到#if defined (STM32F10X_LD_VL) ...这一大段条件编译代码找到对应STM32F10X_MD或STM32F10X_HD的部分确保其调用了SetSysClockTo72()函数。通常标准库的默认实现已经考虑了这一点你需要检查的是确保#define SYSCLK_FREQ_72MHz 72000000被定义。在SetSysClock()函数中找到#ifdef SYSCLK_FREQ_72MHz ... #endif块并确保它最终调用了SetSysClockTo72()。注意直接修改库文件不利于工程迁移。更好的做法是复制system_stm32f10x.c到User目录并修改复制的版本同时在工程中替换原文件。或者在main()中SystemInit()之后再调用RCC库函数重新配置时钟。一个更清晰的、在main中配置时钟的示例void RCC_HSE_Config(void) { ErrorStatus HSEStartUpStatus; /* 复位RCC时钟配置为默认状态对于调试很重要 */ RCC_DeInit(); /* 开启HSE */ RCC_HSEConfig(RCC_HSE_ON); /* 等待HSE稳定 */ HSEStartUpStatus RCC_WaitForHSEStartUp(); if(HSEStartUpStatus SUCCESS) { /* 设置HCLKAHB时钟 SYSCLK */ RCC_HCLKConfig(RCC_SYSCLK_Div1); /* 设置PCLK2APB2高速时钟 HCLK */ RCC_PCLK2Config(RCC_HCLK_Div1); /* 设置PCLK1APB1低速时钟 HCLK/2 (APB1最大36MHz) */ RCC_PCLK1Config(RCC_HCLK_Div2); /* 设置PLL时钟源为HSE 倍频系数为9 - 8MHz * 9 72MHz */ RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); /* 使能PLL */ RCC_PLLCmd(ENABLE); /* 等待PLL就绪 */ while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) RESET); /* 选择PLL作为系统时钟源 */ RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); /* 等待系统时钟源切换成功 */ while(RCC_GetSYSCLKSource() ! 0x08); } /* 使能外设时钟可选在用到时再开启也行 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); }然后在main()函数开头先调用SystemInit()它将时钟初始化为HSI 8MHz再调用RCC_HSE_Config()覆盖配置为72MHz。6.3 工程模板的维护与扩展当你成功创建了这个模板工程后如何用它开始新的项目复制整个工程文件夹将Template_STM32F103文件夹复制一份重命名为你的新项目名。修改工程名在Keil中通过Project - Manage - Project Items修改项目名称或者直接关闭Keil将Project文件夹下的.uvprojx文件重命名。清理中间文件删除Project\Listings和Project\Objects文件夹下的所有内容.uvprojx和.uvoptx除外。编写新代码在User\main.c中开始你的新应用并根据需要在stm32f10x_conf.h中使能新的外设头文件。在Keil工程中添加新的外设驱动源文件.c文件到StdPeriph_Driver分组。在User目录下创建新的.c/.h文件来模块化你的代码。最后一点心得搭建工程的过程看似繁琐但每一步都有其意义。理解目录结构、头文件路径、宏定义和启动文件的作用远比死记硬背步骤重要。这个自己搭建的模板就像你亲手打磨的一把顺手的工具以后无论遇到什么型号的STM32只要还使用标准库你都能快速地上手。遇到问题学会看编译错误信息学会使用调试器查看寄存器这些能力比单纯让LED闪烁更加宝贵。