1. 项目概述与核心价值最近在调试一个基于STM32F103的小型电机驱动板需要用到一个额外的PWM信号来控制一个风扇的转速。板子的主控资源已经分配得差不多了翻看原理图发现PB0这个引脚恰好是空闲的而且它对应着定时器TIM3的通道3。这不巧了嘛直接用TIM3_CH3来输出PWM波既不用动硬件又能完美解决问题。对于很多从标准库StdPeriph Library入门STM32的朋友来说虽然现在HAL/LL库是趋势但标准库的代码结构清晰、寄存器操作直观依然是理解底层原理和进行快速原型开发的利器。这个项目标题“【STM32库函数】使用TIM3的CH3实现PB0口的PWM波输出”就是一个非常经典且实用的切入点。它要解决的核心问题很明确如何通过STM32标准外设库配置一个特定的定时器通道使其在指定的GPIO引脚上输出脉宽调制信号。PWM可以说是单片机控制领域的“万金油”从LED调光、电机调速、舵机控制到开关电源无处不在。掌握如何精准地配置和输出PWM是嵌入式开发的基本功。这个配置过程涉及GPIO复用、定时器时基单元、输出比较模式等多个模块的协同工作对新手理解STM32外设的联动关系非常有帮助。本文将带你完整走一遍流程从工程环境搭建、原理分析、库函数调用到代码编写和调试。我会基于最常见的STM32F103C8T6俗称“蓝桥杯”或“最小系统板”核心型号进行讲解但原理通用你可以轻松移植到F1系列的其他型号。我会重点解释每个配置步骤“为什么”要这么做并分享一些在调试PWM时容易踩坑的地方和实用技巧。2. 硬件连接与原理分析2.1 引脚复用关系解析STM32的GPIO功能非常强大一个物理引脚往往可以复用为多种外设功能这需要通过GPIO的复用功能重映射寄存器来配置。对于我们的目标使用TIM3的通道3TIM3_CH3从PB0输出PWM首先必须查证这个连接关系是否成立。查阅STM32F103xx的数据手册Datasheet或参考手册Reference Manual在引脚定义章节和定时器复用功能映射章节我们可以确认在默认情况下即不复用重映射时定时器TIM3的通道3TIM3_CH3对应的输出引脚就是PB0。这是一个固定的硬件连接我们不需要进行任何重映射操作。这一点非常重要它决定了我们配置的起点。注意并非所有定时器的所有通道都直接连接到某个GPIO。例如TIM3_CH1默认是PA6但可以通过部分重映射功能映射到PB4。对于TIM3_CH3和PB0这个组合是默认连接配置最为简单。2.2 PWM生成的核心原理PWM全称脉冲宽度调制其核心是用一个数字信号来模拟模拟量。一个PWM波由两个关键参数定义频率或周期和占空比。周期Period一个完整PWM波形从高电平开始到下一个高电平开始的时间长度。其倒数即为频率Frequency。频率决定了PWM控制的“细腻度”比如控制LED时频率太低会闪烁控制电机时频率需要避开机械共振点。占空比Duty Cycle在一个周期内高电平时间所占的百分比。占空比直接决定了输出信号的平均电压是控制对象如亮度、速度的关键。在STM32的定时器中是如何硬件实现PWM的呢这依赖于定时器的输出比较Output Compare功能。我们配置定时器以一个固定的频率由预分频器PSC和自动重装载寄存器ARR决定向上或向下计数。同时我们设置一个捕获/比较寄存器CCR。定时器的计数器CNT会不断与CCR值进行比较。当定时器工作在PWM模式1或模式2时计数器CNT开始计数。当CNT CCR时根据模式设置通道输出有效电平通常为高电平。当CNT CCR且CNT ARR时通道输出无效电平通常为低电平。当CNT计数到ARR值溢出时产生更新事件CNT清零重新开始计数输出电平也根据新的CCR值如果已更新进行判断周而复始。这样通过改变ARR值我们改变了PWM的周期通过改变CCR值我们改变了高电平的时间从而改变了占空比。整个过程由硬件自动完成不占用CPU资源非常高效。3. 开发环境准备与工程建立3.1 工具链选择对于标准库开发我们通常需要以下几样东西集成开发环境IDEKeil MDK-ARMµVision或 IAR Embedded Workbench 是经典选择。社区版有代码大小限制但对于学习和小项目足够。本文示例将基于Keil MDK。STM32标准外设库从ST官网下载例如STM32F10x_StdPeriph_Lib。它包含了所有外设的驱动源码、头文件、启动文件和大量示例。目标芯片支持包Device Family Pack在Keil中需要安装对应芯片系列如STM32F1xx的DFP以便编译器识别芯片和进行调试。调试器/编程器ST-Link V2是最常见且性价比高的选择也兼容J-Link等。3.2 标准库工程搭建要点如果你是从零新建一个标准库工程步骤稍显繁琐但结构清晰创建项目文件夹例如Project内部建立User用户代码、Libraries库文件、Output输出文件、Listings列表文件等子文件夹。拷贝库文件将标准库Libraries目录下的CMSIS和STM32F10x_StdPeriph_Driver复制到你的工程Libraries文件夹。拷贝启动文件根据你的芯片Flash容量如STM32F103C8T6是64KB属于中等容量从库的Project/STM32F10x_StdPeriph_Template中找到对应的启动文件如startup_stm32f10x_md.smd代表Medium-density放到User文件夹。创建工程在Keil中新建工程选择你的目标设备如 STM32F103C8。添加文件分组在项目管理窗口中创建分组如User、CMSIS、FWLIB并将对应的.c源文件添加进去。特别注意FWLIB下的外设驱动源文件通常只添加你用到的几个如stm32f10x_gpio.cstm32f10x_tim.cstm32f10x_rcc.c以减小代码体积。配置魔术棒Options for TargetTarget标签勾选Use MicroLIB简化版C库节省空间。C/C标签在Define框中定义全局宏这是关键一步。对于STM32F103系列通常需要USE_STDPERIPH_DRIVER告诉编译器使用标准库和STM32F10X_MD对应中等容量芯片。在Include Paths中添加所有头文件所在路径。Debug标签选择你的调试器如ST-Link并勾选Run to main()。Utilities标签设置调试器的下载算法通常选STM32F10x Medium-density Flash。这个过程对于初学者可能是个挑战但理解一次后受益无穷。网上也有很多现成的标准库工程模板可以拿来作为起点进行修改能节省大量时间。4. 核心代码实现与分步详解下面我们进入核心环节一步步编写代码实现TIM3_CH3在PB0上输出PWM。我们假设目标PWM频率为1kHz初始占空比为50%。4.1 GPIO初始化配置PB0需要被配置为复用推挽输出模式因为定时器的PWM信号是由外设TIM3产生的GPIO只是作为输出引脚。/** * brief 初始化PB0为TIM3_CH3的复用功能输出 * param 无 * retval 无 */ void TIM3_CH3_GPIO_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; // 定义GPIO初始化结构体 /* 第1步开启GPIOB的时钟 */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); /* 第2步配置GPIOB Pin0 */ GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; // 引脚0 GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; // 输出速度50MHz GPIO_Init(GPIOB, GPIO_InitStructure); // 初始化GPIOB }代码解析与注意事项开启时钟任何外设使用前必须先开启其时钟。GPIOB挂载在APB2总线上所以使用RCC_APB2PeriphClockCmd。模式选择GPIO_Mode_AF_PP复用推挽输出是用于外设信号输出的标准模式。推挽输出提供较强的驱动能力高低电平都很稳定。速度选择GPIO_Speed_50MHz指的是IO口的最大响应速度。对于1kHz的PWM这个速度绰绰有余。但在输出更高频率的PWM比如上百kHz时选择更高的速度如50MHz可以减少信号边沿的失真。4.2 定时器时基单元初始化这是配置PWM频率周期的关键步骤。/** * brief 配置TIM3的时基单元决定PWM频率 * param 无 * retval 无 */ void TIM3_Base_Config(void) { TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; // 定义时基初始化结构体 /* 第1步开启TIM3的时钟 */ RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); /* 第2步配置时基单元参数 */ // 假设系统时钟SYSCLK为72MHzAPB1预分频器为2所以TIM3的时钟为72MHz // 目标PWM频率为1kHz (1000Hz) // 定时器计数频率 TIM_CLK / (PSC 1) // PWM频率 定时器计数频率 / (ARR 1) // 我们令 ARR 7199 PSC 0 // 则计数频率 72MHz / (01) 72MHz // PWM频率 72MHz / (71991) 72MHz / 7200 10,000Hz 10kHz等等这里计算有误 // 重新计算若 ARR7199 则周期 T (71991) / 72MHz 7200 / 72e6 0.0001s 0.1ms // 频率 F 1/T 1/0.0001 10,000Hz 10kHz。这不是我们想要的1kHz。 // 正确计算1kHz // Fpwm TIM_CLK / ((PSC1) * (ARR1)) // 72,000,000 / ((PSC1)*(ARR1)) 1000 // (PSC1)*(ARR1) 72000 // 为了得到较高的计数分辨率便于精细调节占空比我们让ARR尽可能大。 // 令 ARR 7199 则 (PSC1) 72000 / (71991) 72000 / 7200 10 // 所以 PSC 9 // 验证Fpwm 72M / (10 * 7200) 72,000,000 / 72,000 1000Hz。正确。 TIM_TimeBaseStructure.TIM_Period 7199; // 自动重装载值 ARR TIM_TimeBaseStructure.TIM_Prescaler 9; // 预分频系数 PSC TIM_TimeBaseStructure.TIM_ClockDivision TIM_CKD_DIV1; // 时钟分频与采样相关通常不分 TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; // 向上计数模式 TIM_TimeBaseInit(TIM3, TIM_TimeBaseStructure); // 初始化TIM3时基单元 }参数计算心得 计算PSC和ARR是配置PWM的第一步也是容易出错的一步。核心公式一定要记牢PWM频率 定时器输入时钟频率 / ((PSC 1) * (ARR 1))。定时器输入时钟频率需要根据你的系统时钟和总线分频情况确定。对于STM32F103如果系统时钟是72MHzTIM2-TIM7挂在APB1上。如果APB1预分频系数是1则定时器时钟为72MHz如果APB1预分频系数是N≠1则定时器时钟是APB1时钟的2倍。这是STM32时钟树的一个特点务必查证。ARR值的选择ARR决定了计数器的最大值也间接决定了占空比调节的分辨率。ARR越大CCR可以设置的值范围就越大0-ARR占空比调节就越精细。例如ARR7199时占空比分辨率是1/7200≈0.0139%。所以在满足频率要求的前提下尽量让ARR大一些。PSC值的作用PSC用于对定时器时钟进行第一次分频以得到合适的计数频率。当所需PWM频率很低时即使ARR取到最大值65535对于16位定时器也可能不够这时就需要增大PSC来降低计数频率。4.3 PWM输出通道初始化这是配置通道工作模式、极性、输出使能的关键。/** * brief 配置TIM3的通道3为PWM输出模式 * param 无 * retval 无 */ void TIM3_CH3_PWM_Config(void) { TIM_OCInitTypeDef TIM_OCInitStructure; // 定义输出比较初始化结构体 /* 第1步配置PWM模式 */ // 初始化结构体通常先赋一个默认值避免随机值影响 TIM_OCStructInit(TIM_OCInitStructure); // 配置为PWM模式1 TIM_OCInitStructure.TIM_OCMode TIM_OCMode_PWM1; // 设置输出比较极性当定时器计数小于CCR时输出有效电平 // TIM_OCPolarity_High 表示有效电平为高电平 TIM_OCInitStructure.TIM_OCPolarity TIM_OCPolarity_High; // 输出使能 TIM_OCInitStructure.TIM_OutputState TIM_OutputState_Enable; // 初始的脉冲宽度占空比设置CCR值 // 占空比 CCR / (ARR1)。ARR7199 50%占空比对应 CCR 3600 TIM_OCInitStructure.TIM_Pulse 3600; // 初始化通道3 TIM_OC3Init(TIM3, TIM_OCInitStructure); // 这个函数很关键它使能通道3的预装载寄存器这样我们修改CCR值时 // 不会立即生效而是在下一次更新事件计数器溢出时才生效防止了PWM波形中出现毛刺。 TIM_OC3PreloadConfig(TIM3, TIM_OCPreload_Enable); }模式与极性详解TIM_OCMode_PWM1 vs PWM2这是两个互补的模式。PWM模式1在向上计数时当CNT CCR通道输出有效电平由极性定义当CNT CCR输出无效电平。PWM模式2逻辑相反当CNT CCR时输出无效电平。 大多数情况下使用PWM模式1配合TIM_OCPolarity_High有效电平为高就是我们最常见的“高电平有效”PWM波。预装载功能PreloadTIM_OCxPreloadConfig这个函数调用至关重要。它开启了对应通道捕获/比较寄存器CCRx的预装载功能。这意味着你通过TIM_SetComparex()函数修改的CCR值会先写入一个“影子寄存器”等到下一次定时器更新事件UEV发生时这个值才会被真正加载到当前工作的CCR寄存器中。这确保了在一个完整的PWM周期内占空比参数是同步更新的避免了在周期中间改变占空比可能导致的脉冲宽度异常比如产生一个极窄或极宽的脉冲保证了波形的稳定和纯净。4.4 主函数整合与使能将以上模块整合并在主函数中调用。#include stm32f10x.h // 函数声明 void TIM3_CH3_GPIO_Config(void); void TIM3_Base_Config(void); void TIM3_CH3_PWM_Config(void); int main(void) { // 1. 初始化GPIO TIM3_CH3_GPIO_Config(); // 2. 初始化定时器时基 TIM3_Base_Config(); // 3. 初始化PWM输出通道 TIM3_CH3_PWM_Config(); // 4. 使能定时器这一步千万别忘了否则计数器不工作。 TIM_Cmd(TIM3, ENABLE); // 5. 使能定时器的主输出对于高级定时器TIM1/TIM8必须对于通用定时器TIM3此函数无实际作用但写上是个好习惯 // TIM_CtrlPWMOutputs(TIM3, ENABLE); // 通用定时器无此功能注释掉或删除 while (1) { // 主循环这里可以添加动态修改占空比的代码 // 例如通过按键或传感器改变 TIM_SetCompare3(TIM3, new_CCR_Value); } }关键点提醒执行顺序初始化顺序一般是 GPIO - 定时器时基 - PWM通道。确保时钟先开启。遗忘的使能TIM_Cmd(TIM3, ENABLE);这行代码是让定时器计数器开始运行的核心。很多初学者配置了一堆参数最后发现没有输出问题往往就出在忘了使能定时器。高级定时器的区别如果你使用的是高级定时器如TIM1, TIM8在输出PWM前还需要调用TIM_CtrlPWMOutputs(TIMx, ENABLE);来使能主输出。但对于我们使用的通用定时器TIM3这个函数是无效的库函数内部会忽略它。知道这个区别可以避免困惑。5. 调试技巧与波形观测代码写完了下载到板子里怎么验证PWM是否正常输出了呢5.1 软件调试方法使用调试器Debugger在Keil中进入调试模式打开逻辑分析仪Logic Analyzer或系统查看器System Viewer。添加要观察的信号比如GPIOB_IDR.0PB0的输入数据寄存器或者直接添加外设信号TIM3-CCR3。虽然不能直接看到模拟波形但可以通过数值变化判断定时器是否在工作CCR值是否被加载。单步执行代码检查各个初始化函数执行后对应的寄存器如TIM3-CR1, TIM3-CCMR2是否被正确配置。变量监测在Watch窗口添加TIM3-CNT和TIM3-CCR3观察它们的值是否在规律变化CNT循环递增CCR3保持不变或按你代码变化这能间接证明定时器在运行且PWM比较逻辑已启用。5.2 硬件测量方法最直接这是最推荐、最直观的方法。工具准备一台数字示波器或逻辑分析仪。对于1kHz的PWM普通的示波器完全够用。连接测量将示波器探头的地线夹在板子的GND上探头尖端接触PB0引脚或者连接到PB0的电路节点。观测波形时基Timebase调整示波器水平时基到大约 1ms/div 或 500µs/div以便能看到多个完整周期。触发Trigger设置为边沿触发通道选择测量通道触发沿为上升沿。观测结果你应该能看到一个稳定的方波。测量其周期应为1ms对应1kHz高电平时间应为0.5ms对应50%占空比。使用示波器的自动测量功能Period, Freq, Duty可以快速读取这些参数。动态测试在while(1)循环中添加一段代码每隔一段时间改变TIM_SetCompare3(TIM3, new_value);的值然后在示波器上观察波形的占空比是否平滑变化。这是验证PWM控制功能是否灵活的好方法。5.3 无仪器情况下的简易判断如果没有示波器也有“土办法”接LED将一个LED串联一个220Ω-1kΩ的限流电阻接到PB0和GND之间。如果PWM输出正常且频率较低比如几十Hz你会看到LED闪烁。如果频率较高超过100Hz由于人眼的视觉暂留你会看到LED呈现不同的亮度。改变CCR值LED亮度应该随之变化。注意这种方法只能定性判断PWM有无输出和占空比是否变化无法得知精确频率和波形质量。万用表测电压使用数字万用表的直流电压档测量PB0引脚对地的电压。如果PWM正常输出万用表显示的是一个平均电压值。对于3.3V系统50%占空比时平均电压应该在1.65V左右。改变占空比这个平均电压值会线性变化。这也是一种间接的验证方法。6. 常见问题排查与解决方案在实际操作中你可能会遇到以下问题这里我整理了排查思路6.1 问题一完全没有波形输出引脚一直是低电平或高电平。检查步骤时钟是否开启这是最常见的原因。双重检查RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE);和RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE);是否被正确调用。GPIO模式是否正确必须配置为GPIO_Mode_AF_PP复用推挽输出。如果错配为GPIO_Mode_Out_PP通用推挽输出定时器无法控制该引脚。定时器使能了吗确认TIM_Cmd(TIM3, ENABLE);被执行。引脚复用映射对吗确认你使用的芯片TIM3_CH3默认就是PB0没有启用重映射。如果原理图或芯片手册有出入需要检查GPIO_PinRemapConfig相关配置。硬件连接用万用表蜂鸣档检查PB0引脚是否确实连接到了你的测量点或负载上有没有虚焊或短路到地/电源。6.2 问题二有波形输出但频率或占空比不对。检查步骤计算错误重新核算PSC和ARR的值。使用公式Fpwm Fclk / ((PSC1)*(ARR1))。务必确认FclkTIM3的输入时钟频率是正确的。参考你的SystemInit()函数或时钟配置代码确认系统时钟和APB1总线时钟。寄存器配置被覆盖有时在多个地方初始化了同一个定时器或者后续代码意外修改了TIM3的寄存器。可以在调试模式下在初始化完成后和主循环中查看TIM3-PSC, TIM3-ARR, TIM3-CCR3等关键寄存器的值是否与你设定的一致。测量方法问题示波器探头衰减比是否设置正确如1:1或10:1时基档位是否合适尝试使用示波器的自动测量功能获取频率和占空比。6.3 问题三波形有毛刺或抖动。检查步骤预装载寄存器未使能这是产生毛刺的主要原因之一。确保调用了TIM_OC3PreloadConfig(TIM3, TIM_OCPreload_Enable);。这样修改CCR值会在更新事件时同步生效波形干净。软件修改CCR的时机如果你在程序中动态修改CCR尽量避免在计数器运行到接近CCR值或ARR值时进行修改。虽然开启了预装载但极端情况下仍可能有问题。可以在计数器为0或一个较小值时修改或者使用定时器的更新中断在中断服务程序里修改。电源噪声为MCU供电的电源是否干净可以尝试在MCU的VDD和GND之间并联一个0.1µF和10µF的电容进行滤波。负载影响如果PB0引脚驱动的负载电流较大如直接驱动电机可能会引起电压波动。建议使用三极管、MOS管或电机驱动芯片进行隔离驱动。6.4 问题四想动态改变频率怎么办通过上面的分析我们知道PWM频率由Fclk、PSC和ARR共同决定。Fclk通常系统运行期间不变。所以动态调频主要就是动态修改PSC或ARR。修改ARR这是最常用的方法因为ARR直接决定了周期。使用TIM_SetAutoreload(TIM3, new_ARR_value);。注意修改ARR可能会影响当前周期的完整性最好在计数器CNT为0时修改或者使用更新事件中断来同步修改。修改PSC使用TIM_PrescalerConfig(TIM3, new_PSC_value, TIM_PSCReloadMode_Immediate);。预分频器有缓冲寄存器可以设置立即更新或下次更新时生效。改变PSC会立刻改变计数频率可能导致当前周期时间异常需谨慎处理。最佳实践对于需要平滑、无毛刺地改变频率通常的步骤是关闭定时器输出或进入刹车状态如果需要。同时更新PSC和ARR先设置新值到预装载寄存器。产生一个更新事件软件触发TIM_GenerateEvent(TIM3, TIM_EventSource_Update);让所有新参数同时生效。重新使能输出。7. 项目扩展与进阶应用掌握了基本的PWM输出后这个项目可以轻松扩展到更多有趣和实用的场景7.1 多通道同步输出TIM3有4个通道CH1-CH4。你可以用几乎相同的配置方法初始化其他通道如CH1在PA6CH2在PA7CH4在PB1让它们输出相同频率、不同占空比或相位差的PWM波。这对于控制多个LED实现流水灯、控制多路舵机、驱动H桥电路等非常有用。关键是它们共享同一个时基单元ARR, PSC因此频率绝对同步。7.2 与中断结合实现复杂控制你可以使能定时器的更新中断UEV或捕获/比较中断CCxIE。更新中断每个PWM周期结束时进入一次中断。可以在这里安全地更新所有通道的CCR值占空比实现复杂的波形序列生成。比较中断当计数器CNT等于某个通道的CCR值时触发。可以用于在PWM周期内的特定时刻执行某些操作比如在PWM波形的中点采样一个传感器信号。7.3 驱动各类负载LED调光直接通过限流电阻驱动小功率LED改变占空比即可无级调节亮度。频率建议在100Hz以上以避免闪烁。舵机控制舵机需要的是周期为20ms50Hz高电平脉宽在0.5ms到2.5ms之间的PWM信号。用本文的方法计算出合适的ARR和PSC然后通过一个按键或ADC采样值来动态改变CCR脉宽即可控制舵机角度。直流电机调速需要通过电机驱动芯片如L298N、TB6612或MOS管桥来驱动。MCU的PWM信号接到驱动芯片的使能或输入引脚通过改变占空比来调节电机两端的平均电压从而实现调速。电机是感性负载PWM频率不宜太低通常几kHz到几十kHz以避免可闻噪音和电流波动过大。蜂鸣器发声用PWM驱动无源蜂鸣器通过快速切换占空比实际上更常用的是切换频率可以产生不同音调的声音。此时PWM的频率就在音频范围内几百Hz到几千Hz。配置PWM的过程本质上是在理解和配置STM32定时器这个强大外设的各个功能单元。从时钟源选择、预分频、自动重装载到输出比较模式、极性、预装载每一步都环环相扣。通过这个具体的“TIM3_CH3 - PB0”项目上手实践一遍你对STM32定时器的理解会上一个坚实的台阶。以后遇到需要其他定时器、其他模式如输入捕获、编码器接口时你会发现底层逻辑是相通的查阅手册和库函数指南会更加得心应手。