简介本资源是一套面向嵌入式初学者与STM32课程实践者的系统性外设实验代码合集聚焦STM32F103C8T6最小系统平台覆盖46个典型外设驱动与应用案例有效解决入门者外设原理难理解、寄存器配置易出错、工程搭建无头绪等共性问题。压缩包共含2000个文件以969个C源文件实现外设初始化、中断服务、数据处理等核心逻辑和1009个H头文件封装寄存器定义、宏配置及函数声明为主体辅以22个HTML格式说明文档总大小244.28MB结构清晰、模块独立便于按需抽取与二次开发。已有299人学习下载每个DEMO均提供完整可运行工程涵盖CRC校验、FLASH读写、MIDI音频播放、双看门狗机制、多路ADC采集光敏/电位器/摇杆/温度、PWM舵机控制、RS485通信及USART收发控制等实战场景代码注释详尽适合作为课程实验参考、毕业设计基础模块或竞赛快速原型开发支撑。1. 项目概述一份面向STM32F103C8的“外设字典”如果你正在学习或者使用STM32F103C8这款经典的“蓝桥杯神片”手头最缺的往往不是开发板而是能直接跑起来、看得懂的例程。网上的资源要么过于零散要么是官方库的英文注释对于新手或者想快速验证某个功能的老手来说效率并不高。我最近整理并重构了一个包含46个常用外设及应用实验的DEMO例程合集核心目标就是解决这个问题把STM32F103C8上那些最常用、最核心的外设功能用最清晰、最直接的方式呈现出来让你拿到手就能编译、下载、看到现象并且能快速理解代码是如何运作的。这个合集不是简单的代码堆砌。每个例程都基于标准外设库Standard Peripheral Library进行编写结构统一注释详尽并且重点考虑了实际开发中容易遇到的坑。比如GPIO的推挽输出和开漏输出到底该怎么选SPI驱动TF卡时为什么时钟相位和极性配置不对就读不到数据ADC采集如何避免电源噪声这些在单纯看数据手册时可能模糊的概念在对应的例程里都有具体的代码实现和关键注释说明。你可以把它看作是一本针对STM32F103C8的“外设功能字典”和“排错手册”无论是入门学习、课程设计、电子竞赛还是产品前期的功能验证它都能提供一个扎实的起点。2. 核心外设驱动例程详解与避坑指南STM32F103C8虽然属于基础型号但其外设丰富度足以应对大多数中等复杂度的应用。这个合集的核心部分就是对这些外设进行逐个击破。下面我挑几个最常用也最容易出问题的外设结合例程代码聊聊里面的门道。2.1 GPIO应用从点灯到高级输入捕获GPIO是所有人第一个接触的外设但用好它并不只是HAL_GPIO_WritePin那么简单。合集里提供了基础输出点亮LED、输入按键检测、以及更复杂的复用功能如配置为USART的TX/RX引脚等例程。关键点1输出模式的选择与驱动能力很多新手点灯时只关心引脚电平却忽略了输出模式。例程中明确区分了推挽输出GPIO_Mode_Out_PP和开漏输出GPIO_Mode_Out_OD。推挽输出这是最常用的模式。单片机内部有上拉和下拉晶体管可以直接输出高电平接近VDD或低电平接近GND驱动能力强最大25mA可以直接驱动LED。例程中驱动LED用的就是此模式。开漏输出只能输出低电平或高阻态。要输出高电平必须依赖外部上拉电阻。这种模式有两个重要用途一是实现“线与”功能多个开漏输出的引脚可以直接连在一起任何一个输出低电平总线就是低电平二是用于驱动高于单片机电压的器件比如通过一个上拉电阻到5V就可以实现3.3V单片机与5V器件的通信如某些I2C设备。在合集关于I2C或模拟I2C的例程中你会看到SCL和SDA引脚被配置为开漏输出。关键点2输入模式与消抖按键检测例程演示了上拉输入GPIO_Mode_IPU模式。STM32芯片内部有可编程的上拉电阻启用后引脚默认被拉高当按键按下接地时引脚变为低电平。这里最大的坑是按键消抖。例程提供了两种方法一是简单的延时消抖在检测到按键按下后延时10-20ms再检测一次这种方法会阻塞CPU二是高级例程中展示的结合定时器中断进行状态扫描的非阻塞式消抖这是产品开发中更推荐的做法。2.2 定时器TIM的三种典型应用定时器是STM32的灵魂外设之一。合集涵盖了定时器最核心的三种应用精确延时、PWM输出和输入捕获。2.2.1 系统滴答定时器SysTick与通用定时器延时SysTick是Cortex-M内核自带的定时器通常用于操作系统的心跳。在无操作系统时我们可以用它实现一个精准的毫秒级延时函数delay_ms()。例程展示了如何配置SysTick的重装载值使其每1ms产生一次中断在中断服务函数里对一个全局变量进行递减。delay_ms()函数就是通过判断这个变量是否减到0来实现阻塞延时的。相比于用循环for(i0;i10000;i)实现的延时它的精度不受编译器优化和CPU主频微小波动的影响。2.2.2 PWM输出控制舵机与LED亮度PWM脉冲宽度调制例程以控制舵机为例。舵机需要周期为20ms50Hz高电平宽度在0.5ms到2.5ms之间的PWM信号。我们使用通用定时器如TIM2的PWM模式来实现。时基配置确定PWM的频率。例如系统时钟72MHz预分频系数设为720-1则计数器时钟为100kHz。设定自动重装载值ARR为2000-1那么PWM周期就是 (720/72M) * 2000 20ms频率50Hz。通道配置将对应通道如TIM_Channel_1设置为PWM模式1或2。模式决定了有效电平是高还是低。占空比设置通过设置捕获/比较寄存器CCR的值来改变高电平时间。CCR值从0到ARR对应0%到100%占空比。对于舵机CCR值设为50对应0.5ms中立位250对应2.5ms最大角度。这个例程的扩展价值很大同样的代码稍作修改改变频率和占空比就可以用于控制直流电机转速通过电机驱动模块或者LED的呼吸灯效果。2.2.3 输入捕获测量脉冲宽度或频率这是定时器的一个高级功能常用于测量编码器信号、红外遥控信号脉宽或超声波模块回响信号的高电平时间。例程以测量一个方波信号的高电平宽度为例。 原理是将定时器通道配置为输入捕获模式上升沿触发。当上升沿到来时硬件会自动将当前计数器的值锁存到CCR寄存器中并产生中断。在中断里我们记录下这个时间戳T1并将触发边沿改为下降沿。当下降沿到来时再次捕获时间戳T2。那么高电平时间就是 (T2 - T1) * 计数周期。这里的关键是定时器时钟频率要足够高以提高测量精度同时要注意计数器溢出的处理。例程中详细展示了如何清除标志位、切换边沿以及计算最终时间。2.3 ADC采集与软件滤波实践STM32F103C8的12位ADC精度不错但直接读取的值往往跳动很大这是因为电源噪声、PCB布局和信号源本身的不稳定造成的。合集里的ADC例程不仅演示了单通道连续转换DMA传输这种高效方式更重点加入了软件滤波算法。例程默认采用了“滑动平均滤波”。它维护一个固定长度的数组比如10个元素每次新的ADC转换结果到来时替换掉数组中最旧的数据然后计算当前数组中所有数据的平均值作为输出。这种方法能有效平滑随机噪声但会引入一定的滞后性响应变慢。在代码中你可以清晰地看到这个队列是如何管理和计算的。注意ADC的参考电压VREF默认连接到VDDA通常也是3.3V。如果你的电源纹波较大ADC读数会整体波动。对于精度要求高的应用如电池电压检测建议使用一个独立的LDO为VDDA和VREF供电并在其引脚附近加上去耦电容。2.4 串口通信USART与printf重定向串口是调试和通信的“瑞士军刀”。例程涵盖了阻塞式发送接收、中断接收以及最实用的printf重定向。printf重定向这个功能极大提升了调试效率。原理是重写C库中的_write或fputc函数将原本输出到标准控制台的数据通过串口发送出去。在例程的usart.c文件中你可以找到如下代码#ifdef __GNUC__ #define PUTCHAR_PROTOTYPE int __io_putchar(int ch) #else #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f) #endif PUTCHAR_PROTOTYPE { USART_SendData(USART1, (uint8_t) ch); while (USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); return ch; }这样在程序中就可以直接使用printf(ADC Value: %d\r\n, adc_value);结果会在串口助手上显示。避坑点确保在调用printf前已经初始化了对应的串口并且开起了微库MicroLIB在Keil的Target Options中勾选否则可能会链接失败或代码体积膨胀。中断接收例程则展示了如何实现一个简单的命令解析器。在串口接收中断服务函数中将收到的字符存入环形缓冲区在主循环里检查并解析缓冲区中的内容。这是实现与上位机如PC、蓝牙模块交互的基础框架。3. 复杂外设与协议栈应用解析掌握了基础外设后就可以挑战一些更复杂的通信协议和存储功能了。这部分例程的代码量更大但结构也更清晰遵循了模块化设计的思想。3.1 SPI驱动TF卡与FATFS文件系统“STM32F103C8 SPI驱动TF卡”是搜索热词也确实是学习SPI和文件系统的一个经典组合。这个例程将整个过程拆解为几个层次硬件SPI初始化配置STM32的SPI1为主机模式模式0或模式3由TF卡规范决定并设置合适的时钟分频初期调试建议用低速如低于1MHz。TF卡底层驱动实现了SD_Init(),SD_ReadSingleBlock(),SD_WriteSingleBlock()等函数。这里最大的坑在于TF卡的初始化流程。它遵循SD协议需要通过CMD0让卡进入空闲状态用CMD8检查电压范围用ACMD41CMD55CMD41进行初始化并等待卡准备就绪。例程的代码严格遵循了这个时序并包含了详细的错误状态判断。FATFS中间层引入了FatFs这个开源通用文件系统模块。我们需要实现diskio.c中的几个底层接口如disk_read、disk_write将它们映射到上述TF卡的读写函数。这一步是连接FatFs和硬件驱动的桥梁。应用层最后我们可以像在PC上一样使用f_open,f_write,f_read,f_close等函数来操作文件。例程演示了创建文件、写入字符串、读取并串口打印的全过程。实操心得第一次调试时务必用逻辑分析仪或示波器抓一下SPI的时钟和数据线波形。重点检查时钟是否连续数据在时钟的哪个边沿采样相位空闲时钟电平是高是低极性这四者CPOL和CPHA构成了SPI的四种模式必须和TF卡的要求一致。例程中已经配置好但如果换用其他SPI设备这里是第一个要检查的地方。3.2 I2C通信与EEPROM读写I2C协议只有两根线SDA数据、SCL时钟但软件时序要求严格。合集提供了软件模拟I2C和硬件I2C两种版本的例程我强烈建议从软件模拟I2C开始学习。因为STM32的硬件I2C在F1系列上曾因设计问题被称为“有缺陷”虽然标准库的驱动已经规避了大部分问题但在复杂总线环境下如多主设备、时钟拉伸仍可能不稳定。软件模拟I2C通过GPIO的置高置低来模拟时序虽然效率低但100%可控极其稳定是产品开发中常用的“保底”方案。例程以读写AT24Cxx系列EEPROM为例。代码清晰地展示了起始条件SCL高电平时SDA一个下降沿。发送一个字节从高位开始在SCL低电平时设置SDA数据然后拉高SCL保持一定时间后再拉低SCL。接收应答发送完8位后释放SDA配置为输入在第9个时钟周期检查SDA是否为低ACK。停止条件SCL高电平时SDA一个上升沿。通过这个例程你不仅能学会操作EEPROM更能透彻理解I2C协议本身以后遇到任何I2C设备如传感器MPU6050、OLED屏幕等只需参照数据手册修改设备地址和寄存器地址即可驱动。3.3 独立看门狗IWDG与系统可靠性对于需要长期稳定运行的产品看门狗是必不可少的“救命稻草”。STM32F103C8包含独立看门狗IWDG和窗口看门狗WWDG。合集例程重点讲解了更常用的IWDG。它的原理很简单启用后一个独立的低速时钟LSI约40kHz驱动的计数器开始递减计数。如果在计数器减到0之前程序没有“喂狗”即重载计数器系统就会产生复位。这用于防止程序跑飞或陷入死循环。配置步骤非常固定取消寄存器写保护IWDG_WriteAccessCmd(IWDG_WriteAccess_Enable);设置预分频和重载值决定“狗”的“饥饿时间”。例如LSI40kHz预分频64则时钟为625Hz。设置重载值为625则超时时间就是1秒625/625。启动看门狗IWDG_Enable();在程序的正常循环或主任务中定期调用IWDG_ReloadCounter();来喂狗。关键提醒喂狗的位置至关重要。绝对不能在定时器中断里无脑喂狗否则即使主程序死锁中断依然在运行狗永远饿不死失去了作用。正确的做法是在主循环的多个关键逻辑节点或者在一个监控任务中喂狗。例程中演示了在主循环中喂狗但在实际复杂系统中需要更精细的设计。4. 综合应用实验与项目框架搭建单个外设跑通只是第一步真正的能力体现在如何将它们组合起来解决实际问题。合集最后一部分提供了几个综合性的DEMO展示了模块化编程和任务调度的初步思想。4.1 多传感器数据采集与上传系统这个DEMO模拟了一个常见的物联网终端场景周期性地采集温度、湿度假设通过模拟I2C读取光照强度通过ADC读取光敏电阻并通过串口以特定格式如JSON打包上传到上位机。代码结构设计如下sensor.c/h封装了DHT11温湿度和光照传感器的初始化、读取函数。内部处理了协议时序和ADC值到物理量勒克斯的转换。data_package.c/h负责将各个传感器的数据打包成一个结构体并提供了转换为字符串用于串口发送的函数。main.c主循环中利用SysTick延时或定时器中断来建立一个简单的定时采集节拍如每2秒一次。采集完成后调用打包函数再通过串口发送出去。这个例程的价值在于展示了“高内聚、低耦合”的编程思想。传感器驱动细节被隐藏在自己的.c文件里主程序只关心调用Sensor_Read()并得到一个结果。当需要更换传感器型号时只需修改对应的驱动文件主程序和其他模块几乎不用动。4.2 基于状态机的菜单界面与按键控制另一个有趣的综合实验是实现一个简单的OLED屏幕菜单系统通过按键进行切换和设置。这里引入了状态机State Machine的编程模型。我们定义几个状态MAIN_MENU主菜单、SETTING_TIME设置时间、SETTING_ALARM设置闹钟等。每个状态对应一个处理函数State_Handler()。在main.c的主循环中核心逻辑就三行while(1) { key KEY_Scan(); // 扫描按键 current_state_handler state_table[current_state]; // 查表获取当前状态的处理函数 current_state_handler(key); // 执行处理并可能返回下一个状态 }状态处理函数内部根据传入的按键值更新显示内容并决定下一个状态是什么。例如在MAIN_MENU状态下按下“下”键光标下移按下“确认”键则跳转到SETTING_TIME状态。这种写法将复杂的界面流程控制分解为一个个独立的状态逻辑清晰易于扩展和维护远比用一堆if-else嵌套要优雅和健壮得多。例程提供了完整的框架你可以很容易地添加新的菜单项和状态。4.3 从裸机到RTOS的思维过渡虽然这个合集基于裸机Bare-metal开发但其中一些例程的设计已经为后续学习实时操作系统RTOS打下了基础。例如定时器节拍SysTick定时器是RTOS的心跳。我们的延时函数已经依赖它。模块化与任务划分综合实验中将数据采集、显示、通信视为独立模块这对应着RTOS中的不同任务。状态机与事件驱动菜单例程就是事件按键驱动状态转换的典型。当你觉得裸机下主循环越来越臃肿各个功能模块之间因为延时、等待而相互阻塞时就是该考虑RTOS的时候了。此时你可以将每个综合实验模块改造成一个RTOS任务利用信号量、消息队列进行同步通信让系统真正“并行”起来。这个合集里的模块化代码可以相对平滑地迁移到RTOS工程中。5. 工程管理与调试技巧分享拥有好例程还要有好的工程管理方法和调试手段才能事半功倍。这部分分享一些合集代码之外但至关重要的实践经验。5.1 如何高效使用这个例程合集这个46合一的工程包并不是一个包含46个main.c的巨大工程。那样会难以管理。我推荐的使用方式是建立个人模板工程在Keil MDK或STM32CubeIDE中创建一个空的、编译通过的工程包含标准外设库、正确的芯片型号、下载调试器配置ST-Link等以及基本的头文件路径。按需拷贝而非直接打开当你想学习ADC时从合集文件夹中找到ADC相关的.c和.h文件拷贝到你模板工程的User目录下。然后将main.c的内容替换为ADC例程的main.c。这样你的工作区始终干净避免文件冲突。善用版本控制即使个人学习也强烈建议使用Git。为你的模板工程初始化一个仓库。每次尝试新例程前先提交一次。如果实验过程中改乱了可以轻松回退。这比手动备份文件夹要可靠得多。5.2 调试利器串口打印与断言Assert除了单步调试串口打印是最直观的调试手段。前面提到的printf重定向一定要熟练掌握。在初始化、关键函数入口、错误分支处都加上打印信息就像给程序装上了“黑匣子”。更进一步可以使用断言Assert。在标准外设库的stm32f10x_conf.h中可以启用USE_FULL_ASSERT宏。启用后库函数内部会对参数进行合法性检查如果传入非法参数如错误的GPIO引脚号会调用assert_failed函数。你可以在main.c附近自己实现这个函数在里面打印出错的文件名和行号然后进入死循环。这能在开发阶段快速定位到明显错误的调用而不是让程序跑飞到一个莫名其妙的地方。#ifdef USE_FULL_ASSERT void assert_failed(uint8_t* file, uint32_t line) { printf(Assert failed: %s, line %d\r\n, file, line); while(1); } #endif5.3 常见编译与下载问题排查问题1程序下载后不运行。检查启动文件确保工程中包含的启动文件如startup_stm32f10x_md.s与你的芯片型号匹配。C8属于中等容量对应mdMedium Density。检查BOOT引脚确保BOOT0和BOOT1引脚通常是跳线帽被正确设置为从主闪存启动BOOT00。检查时钟配置如果程序里使用了外部晶振HSE但板子上没有焊接或者SystemInit()函数里的时钟配置有误会导致系统时钟无法启动程序“卡死”在开头。初期调试可以先用内部RC振荡器HSI的配置。问题2程序运行一段时间后死机。堆栈溢出这是最常见的原因之一。在启动文件中定义的堆栈大小Stack Size可能不够。如果你的函数嵌套很深或使用了大的局部数组可以尝试在IDE的设置里将堆栈调大如从0x400调到0x800。中断冲突或未清除标志某个中断服务函数执行时间过长或者退出时没有清除相应的中断标志导致连续不断地进入中断使主程序无法执行。仔细检查你的中断服务函数。内存访问越界数组操作或指针操作写穿了破坏了其他变量或关键数据。使用调试器观察程序死机前哪个数组的索引值异常大。这份基于STM32F103C8的46个例程合集其价值不在于代码本身而在于它提供了一套经过验证的、可复用的外设驱动框架和问题解决方案。我的建议是不要仅仅满足于“跑通”而是选择一个你最感兴趣的综合实验比如“SPI驱动TF卡记录数据”然后尝试去修改它、扩展它——增加一个RTC时间戳、用按键控制开始/停止记录、通过串口发送文件列表……在动手改造的过程中你会遇到无数个具体的小问题解决它们的过程才是真正掌握STM32开发的捷径。本文还有配套的精品资源点击获取