简介本资源是一套面向嵌入式初学者与STM32开发者的标准库函数实践教程基于STM32F103系列Cortex-M3内核设计聚焦库函数编程范式覆盖GPIO、定时器、PWM、SPI、DAC、1-WireDS18B20、SDIOSD卡等核心外设的典型应用有效解决入门者对HAL之外传统库开发路径不熟悉、外设驱动调试无从下手等问题。压缩包含3274个文件总计28.63MB其中C源文件1219个与头文件1242个构成主体代码逻辑OBJ/HEX/AXF等编译产物共约300个便于直接烧录验证UVPROJX/UVGUIX工程文件超200个支持Keil MDK一键打开配套PNG图示与TXT说明辅助理解。已有560人学习下载资源按ALIENTEK MINISTM32开发板实验体系组织从Template模板工程起步逐层递进至SD卡文件系统等高阶应用目录模块清晰、命名规范可直接复用到课程设计、毕业设计及小型物联网终端开发中。 手头这份“STM32F103标准例程-V3”凡是搜过STM32F103库函数资料的人大概率都下载过。它是网上流传很广的一套基于标准外设库V3.5整理的外设驱动Demo覆盖GPIO、串口、定时器、CAN、SPI这些常用模块也是很多入门者跟着敲的第一套代码。现在HAL库加CubeMX生成工程几乎成了默认玩法很多人觉得标准的库函数例程已经过时了。但我可以负责任地说一句如果你想把STM32的寄存器级行为、外设时钟关系、中断和DMA机制吃透这份库函数例程包仍然是目前最值得反复翻的资料之一。这篇文章不打算复述例程里的每一行代码而是结合我自己用这套例程做项目、带新人、调板子的经历把这份V3例程背后的工程结构、关键外设配置思路、以及与硬件联调时最容易踩的坑都拆开讲一遍。适合刚拿到开发板不知道从哪里下手的初学者也适合已经用HAL库写过一阵子、想回头补底层基本功的开发者。1. 为什么现在还要啃库函数例程1.1 库函数与HAL库的定位差异你得先搞清楚标准外设库StdPeriph Library和HAL库到底差在哪。按我的理解标准库是“寄存器操作的封装”HAL库是“状态机式的抽象”。标准库没解决你的工程结构问题只是让你用GPIO_Init代替直接写GPIOB-CRL而HAL库把外设的整个生命周期都接管了你调HAL_UART_Transmit时背后是发送状态机在跑。两者的学习成本不一样。标准库的每一层封装都能顺藤摸瓜找到寄存器比如GPIO_Init最终就是设置CRL/CRH那几位HAL库的函数调用链条长中间夹着大量断言、锁、状态校验新手很容易迷失在huart-gState这类逻辑里。对比维度标准外设库 V3.5HAL库代码抽象层级偏底层接近寄存器高层带状态机依赖CubeMX不需要生成代码更高效学习底层原理友好调用链短封装深容易黑盒化代码体积/效率较小效率可控较大切片多资料与例程老例程极其丰富新例程多但深度参差实际产品存量国内大量老产品在用新项目的主流看到这里你应该明白我的态度了库函数例程不是不能用而是它更接近硬件本质适合用来建立正确的心智模型。1.2 V3例程包里的核心价值这份V3例程包的最大价值不是代码量大而是“外设覆盖全、依赖清晰”。它基本按官方标准库的Demo改过来每个例程都是一个独立的工程你打开就能编译烧进去就能看到现象。这种“独立工程”的形态特别适合做实验——比如你今天想试CAN通讯不用从零搭工程直接打开CAN例程改几行就行。其次它保留了完整的外设初始化代码没有用任何自动生成工具。这意味着你在stm32f10x_gpio.c里看到的每一个函数都能在参考手册里找到对应的寄存器描述。我曾经带过一个新人他问为什么GPIO_InitStructure.GPIO_Speed要设成GPIO_Speed_50MHz这个问题放在HAL库时代基本不会有人想到而标准库例程天然逼着你去想。再者V3例程包对板子的适配程度很高。针对STM32F103C8T6小板、ZET6大板这些常见型号都有对应的工程配置连启动文件、器件宏都预设好了。你不需要在工程设置里折腾太久这是它作为“例程”最本分的价值。1.3 学习库函数例程的正确打开方式不要从头到尾“读”代码而是带着任务去“拆”代码。我的建议是拿到例程包后先跑通一个最简单的GPIO点灯例程对照原理图确认LED接在哪个引脚、高电平还是低电平点亮然后在此基础上自己改一个LED闪烁程序把Delay换成定时器中断再往后把按键中断加进来串口打印调试信息把整个“输入-处理-输出”的闭环跑起来。这个顺序的核心逻辑是先掌握“引脚级别的输入输出”再进入“外设级别”的串口、PWM、CAN最后才是“系统级别”的中断优先级、DMA和低功耗。每一层都依赖前面建立的基础顺序反了会非常痛苦。提示学习时手边一定要有《STM32F10x中文参考手册》和《Cortex-M3权威指南》电子版。例程里的函数只是结论你要在参考手册里找到它对应的寄存器章节这个“对照”过程才是真正的学习。2. 例程包工程结构与搭建思路2.1 标准外设库目录结构说明打开V3例程包你会先看到Libraries、Project、User这几个主要目录。Libraries里又分CMSIS和STM32F10x_StdPeriph_Driver两部分前者是Cortex-M3内核相关的核心文件和启动文件后者是外设驱动的源文件和头文件。有一点容易被忽略CMSIS目录下的system_stm32f10x.c负责系统时钟初始化里面定义了SystemInit()它会根据stm32f10x.h里的HSE_VALUE和SYSCLK_FREQ_*宏把主频配置到72MHz。如果你换了板子上的晶振频率比如从8MHz换成12MHz只改工程配置是不够的还得改这里的宏定义否则串口波特率会算错这在后面排查乱码问题时会反复遇到。Project目录下是各外设的独立工程每个工程里都包含了stm32f10x_conf.h这个外设配置文件。它的作用是把用到的外设头文件包含进来注释掉不用的模块能加快编译速度。新手不用在这里省时间全保留就好。2.2 工程配置的关键宏与启动文件标准库工程能编译过靠的是两个关键宏USE_STDPERIPH_DRIVER和STM32F10X_MD。前者告诉编译器“我要使用标准外设库”后者告诉它“我的芯片是中容量型号”。这两个宏在Keil的C/C选项卡里配置少一个都会报出一堆“找不到定义”的错误。启动文件的选择同样关键。STM32F103系列根据Flash容量分成小容量、中容量、大容量对应startup_stm32f10x_ld.s、startup_stm32f10x_md.s、startup_stm32f10x_hd.s。C8T6属于中容量64KB FlashZET6属于大容量512KB Flash选错了启动文件程序上电后跑飞的可能性极高。V3例程包在工程里默认选了MD版本如果你用的是大容量芯片记得把启动文件换成HD版本同时把宏改成STM32F10X_HD。还有个易错点C8T6虽然只有64KB Flash但它和ZET6的引脚定义在很多外设上是兼容的所以网上有些例程直接拿大容量工程改成C8T6也能跑。但“能跑”不代表“配置正确”中断向量表长度都不同长远看不推荐这么干。2.3 最小系统板选型与常见坑V3例程包最常搭配的硬件就是“STM32F103C8T6蓝色小板”和“STM32F103ZET6正点原子/野火大板”。蓝色小板最便宜二十几块就能拿到配合ST-Link V2调试器一套入门工具不超过五十块。但我强烈建议额外准备一个独立的3.3V稳压模块因为小板上自带的AMS1117在某些大负载场景下会发热掉压导致程序莫名其妙复位。另一个常见坑是BOOT0引脚的默认状态。蓝色小板出厂BOOT0一般是低电平从Flash启动这没问题。但如果你刷过串口ISP把BOOT0拉高过之后忘了拉回来程序会卡在系统存储器引导区表现就是程序不运行、调试器连不上。遇到这种“芯片没反应”的情况第一个去检查BOOT0的电平十有八九是它。3. 核心外设例程逐个拆解3.1 GPIO点灯与按键输入——一切外设的起点GPIO例程看着简单其实包含了两类最基础的操作输出和输入。输出例程里初始化结构体选择GPIO_Mode_Out_PP也就是推挽输出拉高拉低能力都很强驱动LED正合适。至于GPIO_Speed_50MHz实际上决定了IO口的翻转速率上限普通LED用2MHz也完全够没必要追求最高速度。按键输入例程里关键点是GPIO_Mode_IPU也就是上拉输入。按键一端接GND、另一端接引脚时按下为低电平松开为上拉高电平。为什么不用GPIO_Mode_IN_FLOATING因为浮空输入在按键悬空时电平不定干扰一来就可能误触发加上内部上拉电阻才能保证稳定。// LED初始化以PB0为例 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_SetBits(GPIOB, GPIO_Pin_0); // 输出高电平熄灭或点亮取决于电路// 按键扫描以PA0为例按下为低电平 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; // 上拉输入 GPIO_Init(GPIOA, GPIO_InitStructure); if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) RESET) { // 按键按下 }这里有个实际开发中很容易忽略的细节GPIO外设的时钟必须单独使能。STM32F103的所有GPIO都挂在APB2总线上不使能时钟的话对寄存器的写操作石沉大海点灯毫无反应。V3例程包里的每个例程都写了RCC_APB2PeriphClockCmd但这行代码是新手最容易漏掉的。3.2 串口USART1——调试的生命线串口是嵌入式开发最重要的调试手段V3例程包里USART1的配置也最典型。STM32F103系列芯片的USART1默认引脚是PA9TX和PA10RX这个组合在高热词里频繁出现不是没有原因的——它几乎出现在每一块F103最小系统板上是做串口ISP下载和调试通信的“官方通道”。PA9和PA10的初始化模式不一样这点很多初学者分不清。TX脚要配置成GPIO_Mode_AF_PP也就是复用推挽输出因为引脚的控制权从GPIO交给了USART外设RX脚配置成GPIO_Mode_IN_FLOATING让USART输入浮空等待外部电平驱动。如果两项都设成普通的推挽输出串口只能发不能收。// USART1 GPIO初始化 GPIO_InitStructure.GPIO_Pin GPIO_Pin_9; // TX GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; // 复用推挽 GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_10; // RX GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure);// USART1 参数配置 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);波特率配置背后有一个“为什么”USART1挂在APB2总线上工作时钟是72MHz要得到115200bps的波特率硬件里是通过分频寄存器算出来的。如果你主频不是72MHz比如外部晶振换成了12MHz而系统时钟只跑到36MHz那波特率就全错串口助手收到的全是乱码。这也是我前面强调system_stm32f10x.c里时钟配置重要性的原因。3.3 定时器PWM——输出频率与占空比计算PWM例程是V3例程包里含金量很高的一份因为“输出频率可调PWM”这六个字在实际项目中几乎天天遇到比如调风扇转速、调LED亮度、控制舵机角度。PWM输出靠定时器比较捕获通道完成核心参数就是预分频值PSC和自动重载值ARR。公式其实很简单PWM频率 定时器时钟 / (PSC1) / (ARR1)占空比 CCR / (ARR1)以STM32F103的TIM2为例APB1预分频为2时定时器实际时钟是72MHz。想要1kHz的PWM最简单的做法是PSC分到1MHzARR取999公式就是72MHz / 72 / 1000 1kHz此时占空比精度是千分之一足够绝大多数电机和灯光控制用。// TIM2输出1kHz、50%占空比的PWM从PA0输出 TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); // 72MHz / (711) 1MHz TIM_TimeBaseStructure.TIM_Prescaler 71; // 1MHz / (9991) 1kHz TIM_TimeBaseStructure.TIM_Period 999; TIM_TimeBaseStructure.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, TIM_TimeBaseStructure); // 占空比 500 / (9991) 50% TIM_OCInitStructure.TIM_OCMode TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse 500; TIM_OCInitStructure.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC1Init(TIM2, TIM_OCInitStructure); TIM_Cmd(TIM2, ENABLE);如果你用的是TIM1或者TIM8注意它们是高级定时器PWM配置完后必须调用TIM_CtrlPWMOutputs(TIM1, ENABLE)否则主输出关了引脚不会有波形。这个坑在新手用TIM1输出PWM时特别容易出现属于“配置看起来全对、示波器就是没波形”的典型原因。3.4 CAN通讯例程——从回环到双机通信CAN通讯是V3例程包里最让人头疼也最有价值的一份。STM32F103的bxCAN模块支持2.0A和2.0B协议硬件层已经实现了仲裁、错误检测、重发机制你只需要配置波特率、过滤器和工作模式就能用。调试CAN例程时强烈建议先跑CAN_Mode_LoopBack也就是回环模式。这个模式下数据不会发到总线上而是芯片内部自发自收不需要CAN收发器也不需要第二块板子就能验证CAN外设本身有没有问题。确定回环测试通过后再把模式改成CAN_Mode_Normal接上TJA1050这类收发器做双机通信。CAN的波特率计算也是经典问题。它不像串口那样用一个整数分频就能算出来而是由分频、BS1、BS2三个参数共同决定公式为波特率 APB1时钟 / (CAN_Prescaler * (1 BS1 BS2))。APB1时钟是36MHz想要500kbps可以取Prescaler9BS16BS21代入公式就是36MHz / (9 * 8) 500kHz。CAN_InitTypeDef CAN_InitStructure; CAN_InitStructure.CAN_Prescaler 9; CAN_InitStructure.CAN_Mode CAN_Mode_Normal; // 先改成 CAN_Mode_LoopBack 测试 CAN_InitStructure.CAN_SJW CAN_SJW_1tq; CAN_InitStructure.CAN_BS1 CAN_BS1_6tq; CAN_InitStructure.CAN_BS2 CAN_BS2_1tq; CAN_InitStructure.CAN_TTCM DISABLE; CAN_InitStructure.CAN_ABOM ENABLE; CAN_InitStructure.CAN_AWUM DISABLE; CAN_InitStructure.CAN_NART DISABLE; CAN_InitStructure.CAN_RFLM DISABLE; CAN_InitStructure.CAN_TXFP DISABLE; CAN_Init(CAN1, CAN_InitStructure);过滤器配置是CAN例程的另一个难点。bxCAN有28个过滤器每个都能独立配置成列表模式或掩码模式。简单理解列表模式就是“只接收ID完全匹配的帧”掩码模式就是“ID的某些位必须匹配其他位任意”。例程包里常用掩码模式配置成接收全部帧屏蔽位全为0这便于前期调试但正式项目一定要按节点ID收窄否则总线上任何一帧都会打断你的串口或中断。3.5 SPI外设与编码器测速SPI例程和编码器测速例程我放在一起讲因为它们在F103项目里往往同时出现SPI用来驱动显示屏、Flash芯片或传感器编码器用来测电机转速。热词里出现的“SPI驱动TI7567”这类外设本质就是在F103的SPI主机上对接一个SPI从设备时序配置对了就能通信。SPI配置时最容易出错的是时钟极性和相位也就是CPOL和CPHA。这两个参数决定了数据在时钟的哪个沿采样、哪个沿改变。一定要去查从设备数据手册里对时序的要求不能想当然。比如很多显示屏控制器要求在空闲时时钟为低、第一个边沿采样对应的配置就是SPI_CPOL_Low和SPI_CPHA_1Edge。如果时序不对最常见的现象是通信偶尔正常、偶尔乱码或者读回来的寄存器值错位。// SPI1主机模式初始化 SPI_InitTypeDef SPI_InitStructure; SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_16; SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE);编码器测速例程利用了定时器的编码器接口模式不用外部中断硬件就能根据A、B相脉冲自动加减计数。配置上核心是一行TIM_EncoderInterfaceConfig设置计数模式和输入捕获极性。实测下来如果电机在转但计数器不增不减多半是A、B相接反了只需要把两根线对调或者在配置里交换TI1和TI2的极性即可。转速换算也是个容易算错的地方。假设编码器每转500个脉冲采用TI1和TI2双边沿计数时一个机械周期会产生4倍频脉冲也就是2000个计数。你在固定时间窗口比如100ms读取一次CNT差值那么转速的计算就是每转脉冲数除以窗口内差值再换算成RPM。我用一个具体例子100ms内CNT涨了400对应机械角度是400/2000圈0.2圈也就是每秒2圈转速120rpm。实际操作中建议用定时器中断固定采样周期避免主循环抖动带来的测速误差。4. 联调中反复踩过的硬件与工具链问题4.1 下载与调试环节V3例程包年代较早很多资料默认你使用J-Link或者ST-Link。现在ST-Link V2几乎人手一个价格便宜、驱动稳定对F103的SWD下载支持非常好。接线只需要四根SWDIO、SWCLK、GND、3.3V比JTAG的二十根线省事太多。下载失败的排查是有固定顺序的。第一看Keil里芯片型号选没选对STM32F103C8和STM32F103ZE在Device选项卡里是完全不同的设备描述选错会直接导致flash算法不匹配。第二检查Debug选项卡里是否选择了ST-Link Debugger以及Settings里能否识别到IDCODE识别不到就查物理连接和驱动。第三确认板子供电很多小板用ST-Link的3.3V输出供电但ST-Link输出能力有限如果板上还挂着无线模块、OLED屏这些外设电压一掉就进入“连不上”状态。还有一个很隐蔽的问题如果代码里把SWD引脚给复用了比如GPIO_PinAll配置成普通GPIO或者调试器进低功耗模式后SWCLK被关闭就会出现“第一次能下载烧进某段代码后第二次再也连不上”。解决办法是按住板子复位键在Keil点击下载的瞬间松开复位让芯片在启动阶段被调试器抓住。这个“擦除恢复”操作我一年里怎么也得用上十几次。4.2 PC端工具链问题现在很多初学者在Windows上遇到的一个高频报错是“OSError: [WinError 1114] 动态链接库(DLL)初始化例程失败”这往往不是STM32工程本身的问题而是PC端工具链出了状况。常见场景包括Keil安装后打开工程报某个DLL加载失败、Python脚本调用第三方库时报同样错误、或者是ST-Link驱动工具初始化异常。这类问题的根源多半是系统缺少C运行库或者杀毒软件把动态库文件隔离了。解决办法很朴素去微软官网装一遍最新的VC运行库合集把报错日志里指向的DLL文件路径用资源管理器打开确认是否存在用管理员身份运行Keil或者终端最后查一下杀毒软件隔离区有没有被误删除的文件。这套组合拳能解决九成以上的DLL加载问题。注意如果同一台电脑上同时装了多个版本的Keil或者曾卸载过其他IDEDLL冲突的概率极高。有条件的话把Keil升级到5.3x以上对老工程和新调试器的兼容性都要好很多。5. 新手的常见问题速查这节整理成一张速查表都是我在用V3例程包过程中亲眼见过、亲手解决过的问题。碰到对应现象直接对着查能省不少折腾时间。现象可能原因处理方向编译报错main.c: cannot open source input file stm32f10x.hinclude路径没配置Options for Target - C/C - Include Paths 添加固件库头文件路径编译报错identifier GPIO_Pin_0 is undefined缺少标准外设库头文件检查stm32f10x_conf.h是否包含stm32f10x_gpio.h确认已定义USE_STDPERIPH_DRIVER下载时提示No Target Connected接线、驱动或BOOT0问题查SWD四线连接、查驱动是否安装、查BOOT0是否为低电平串口输出全乱码晶振频率与HSE_VALUE不一致检查外部晶振实际频率修改stm32f10x.h的HSE_VALUE为8M或12M串口只发不收RX引脚模式配置错误确认RX脚是GPIO_Mode_IN_FLOATINGTX脚是GPIO_Mode_AF_PPPWM引脚无波形高级定时器主输出未使能TIM1/TIM8需调用TIM_CtrlPWMOutputs(TIMx, ENABLE)第一次能下载之后连不上SWD引脚被复用或芯片进入休眠按住复位再点下载或用擦除工具恢复CAN回环正常、双机不通波特率不一致或收发器问题用示波器看CAN_H/CAN_L差分信号确认两边波特率参数完全一致编码器读数乱跳未滤波或A/B接反开启TIM_ICFilter滤波交换A/B相检查共地程序正常运行但复位键没反应复位电路电容过大100nF即可不要用10uF级别的电容挂NRST我还想单独强调一个经验V3例程包里的Delay函数用的是SysTick做的软件延时如果系统时钟没配成72MHz延时会成倍缩短或拉长。表现为“程序点了灯但是LED闪烁频率很奇怪”这时候不要怀疑代码逻辑先确认主频。最简单的验证办法是用定时器输出一个已知频率的PWM示波器量出来的频率就是最真实的时钟反馈。6. 例程之外的扩展用法这份V3例程包讲“够用”没问题但我建议你把它当跳板而不是终点。例程里模块和模块之间是割裂的GPIO是GPIO串口是串口CAN是CAN。而实际项目里它们永远在协作——串口收到指令解析后通过CAN转发PWM输出改变电机转速编码器测速结果再通过串口回传。数据流串起来才算真正用活这些外设。在标准库的基础上你自己动手把几个模块组合成一个小系统哪怕只是“串口控制LED亮度”这样的小玩意价值都比跑完十个独立例程大。我当年就是靠把例程拼装成一个小项目才彻底搞懂了中断优先级、DMA通道和外设时钟之间的纠缠关系。另外如果你后续打算转向HAL库手头有标准库的底子会轻松很多。你看到HAL的HAL_GPIO_TogglePin能立刻想到它背后是对ODR寄存器的操作看到HAL_UART_Receive_IT能理解它对应USART的中断向量和NVIC配置。这些对应关系正是库函数例程给你留下的最大财富。本文还有配套的精品资源点击获取