1. 项目概述从定时器到PWM的工程实践最近在调试一个电机控制板核心需求是用STM32F103的定时器输出一路频率和占空比都可调的PWM信号来驱动MOS管。听起来是个基础操作但实际动手时从定时器模式选择、通道配置到最终在示波器上看到干净稳定的方波中间还是有不少细节需要捋清楚。特别是对于刚从标准库转向HAL库或者习惯了某种固定配置模式的朋友换个项目换个需求可能又会遇到“为什么没有波形输出”这类经典问题。这篇文章我就以STM32F103C8T6这款经典的“蓝桥杯”芯片为例拆解一下如何使用其通用定时器TIM2, TIM3, TIM4来生成PWM。我会结合CubeMX配置和代码重点讲清楚背后的原理和那些容易踩坑的配置项目标是让你看完后不仅能配出来更能明白为什么要这么配遇到问题知道从哪里下手查。PWM脉宽调制说白了就是通过调节一个周期固定方波的“高电平时间”占整个周期的比例即占空比来等效地输出不同的“平均电压”。在嵌入式里它可是驱动电机调速、控制舵机转角、调节LED亮度呼吸灯的万金油。STM32F103的定时器功能强大其中通用定时器是产生PWM的主力。理解了这个你再去看高级定时器的互补输出、死区插入这些高级功能也会更有底气。2. 核心原理与硬件架构拆解2.1 STM32F103定时器家族与PWM能力概览STM32F103的定时器是个大家庭大体分三类基本定时器TIM6, TIM7、通用定时器TIM2, TIM3, TIM4, TIM5和高级定时器TIM1, TIM8。对于输出PWM这个任务我们主要关注通用定时器和高级定时器。基本定时器功能最简单只能向上计数通常用于单纯的时基或者DAC触发它没有输出比较功能所以不能直接产生PWM。这一点首先要明确别在TIM6/TIM7上浪费时间找PWM输出引脚。通用定时器是我们今天的主角。以TIM2/TIM3/TIM4为例它们都是16位向上、向下或向上/向下中央对齐计数模式每个定时器有4个独立的通道TIM2和TIM5是32位的但通道数也是4个每个通道都可以被配置为输入捕获、输出比较或者PWM输出模式。当配置为PWM模式时定时器会根据计数器CNT的值和捕获/比较寄存器CCRx的值进行比较从而在对应的输出引脚上产生电平跳变形成PWM波形。通用定时器功能全面足以应对大多数PWM应用场景如LED调光、蜂鸣器驱动、简易电机调速等。高级定时器TIM1/TIM8在通用定时器的基础上增加了互补输出、死区插入、刹车功能等专门为电机控制和电源应用设计。如果你需要驱动三相电机、或者需要防止上下桥臂直通那就必须用到高级定时器的这些高级特性。但它的基础PWM生成原理和通用定时器是一致的。选择哪个定时器第一看引脚是否方便第二看功能是否满足。例如TIM2的通道1CH1对应PA0但PA0常常用作唤醒引脚WKUP如果项目要用到唤醒功能这个引脚就可能冲突。所以在CubeMX里分配引脚时要有全局观。2.2 PWM生成的底层逻辑比较与匹配理解PWM如何产生关键在于理解定时器的两个核心寄存器自动重装载寄存器ARR和捕获/比较寄存器CCRx。你可以把定时器想象成一个不断循环的沙漏。ARR决定了这个沙漏的“容量”也就是PWM的周期。计数器CNT就像沙漏里的沙子从0开始一粒一粒增加向上计数。CCRx则是一个我们预设的“刻度线”。定时器的工作流程是这样的时钟源驱动内部时钟APB总线时钟经过分频或倍频驱动着计数器CNT递增。比较与输出在每个时钟周期硬件都会比较CNT的值和CCRx的值。在PWM模式1下通常的规则是当CNT CCRx时输出有效电平高或低可配置当CNT CCRx且CNT ARR时输出无效电平。周期重置当CNT计数到ARR的值时产生一个“更新事件”UEVCNT被硬件清零向上计数模式然后开始下一个计数周期。如此周而复始。所以ARR决定了PWM的频率周期CCRx决定了PWM的占空比。频率Fpwm 定时器时钟频率 / ((ARR 1) * (PSC 1))。其中PSC是预分频器寄存器用于降低计数时钟频率以适应更低的PWM频率需求。占空比Duty CCRx / (ARR 1)。这里有个关键点ARR和CCRx都是16位寄存器对于通用定时器最大值65535。在计算频率和设置占空比时我们通常操作的是ARR和CCRx的“影子寄存器”通过__HAL_TIM_SET_AUTORELOAD()和__HAL_TIM_SET_COMPARE()这类宏或函数来设置硬件会在下一个更新事件时自动将影子寄存器的值加载到实际工作的寄存器中这样可以避免在周期中间修改参数导致波形出现毛刺。2.3 引脚复用与硬件连接要点STM32的引脚功能是复用的一个PA8引脚既可以是普通GPIO也可以是TIM1的通道1还可能是USART1的CK线。因此使用定时器输出PWM必须将对应引脚配置为复用推挽输出模式Alternate Function Push-Pull。以TIM3的通道2CH2为例它可能映射到PB5默认或者PC7重映射。你需要在芯片数据手册的“引脚定义”章节或CubeMX的引脚分配图中确认。在CubeMX中你直接点击对应定时器通道选择“PWM Generation CHx”软件会自动帮你把引脚模式配置好。注意STM32F103的定时器引脚有部分重映射和完全重映射功能通过AFIO寄存器控制。在标准库中需要手动调用GPIO_PinRemapConfig函数。在HAL库配合CubeMX时如果使用了重映射引脚CubeMX通常会自动生成AFIO配置代码但最好在生成的MX_TIMx_Init()函数附近检查一下确保重映射代码已生效。硬件连接上PWM输出引脚直接驱动LED或通过限流电阻驱动三极管基极是没问题的。但如果要驱动电机尤其是直流有刷电机或舵机通常需要接一个电机驱动芯片如L298N、TB6612等。PWM信号接到驱动芯片的使能或输入引脚通过改变PWM占空比来控制电机两端的平均电压从而实现调速。绝对不要试图用MCU的IO口直接驱动电机电流不够还会损坏单片机。3. 基于CubeMX与HAL库的配置实战理论讲完了我们动手配一个。目标使用TIM3的通道2PB5引脚输出一个频率为1kHz占空比为50%的PWM信号。3.1 CubeMX工程初始化与定时器参数计算首先在CubeMX中创建新工程选择你的芯片型号如STM32F103C8Tx。在Pinout Configuration视图下在左侧分类中找到Timers展开并选中TIM3。在下方配置面板将Clock Source设为Internal Clock内部时钟。找到Channel2选择PWM Generation CH2。此时右侧的原理图上PB5引脚应该会被自动标记为TIM3_CH2。接下来是关键参数计算在Parameter Settings标签页Prescaler (PSC - 预分频器)这个值决定了定时器计数时钟CK_CNT的频率。CK_CNT TIMxCLK / (PSC 1)。TIM3挂载在APB1总线上APB1的时钟频率默认是系统时钟72MHz的一半即36MHz。但注意如果APB1预分频系数不为1定时器时钟会倍频x2。在默认的72MHz系统时钟、APB1预分频器为2的配置下APB1时钟是36MHz而TIM3的时钟TIMxCLK是72MHz。我们假设系统时钟为72MHz且TIM3时钟为72MHz。 为了得到1kHz的PWM我们先设定一个目标计数频率。假设我们让ARR设为999那么CK_CNT Fpwm * (ARR1) 1kHz * 1000 1MHz。 因此PSC (TIMxCLK / CK_CNT) - 1 (72MHz / 1MHz) - 1 71。在CubeMX中填入71。Counter Mode (计数模式)选择Up向上计数。这是最常用的模式。Counter Period (ARR - 自动重装载值)根据上面计算我们想要1000个计数周期所以ARR 1000 - 1 999。填入999。auto-reload preload (自动重载预装载)建议使能Enable。这对应着ARR的影子寄存器功能。使能后你修改ARR的值不会立即生效而是等到下一个更新事件这样可以避免在PWM周期中间更新周期值导致波形错乱。PWM Generation Channel 2 子配置Mode (模式)选择PWM mode 1。在这个模式下当CNT CCRx时输出有效电平CNT CCRx时输出无效电平。Pulse (CCR2 - 脉冲值)这个就是占空比对应的CCRx值。占空比50%即CCR2 (ARR 1) * 50% 1000 * 0.5 500。填入500。Fast Mode (快速模式)禁用。这个模式用于在CCRx与CNT匹配时强制输出反转而不是等到下一个周期。在普通PWM应用中不需要。CH Polarity (通道极性)选择High。这意味着“有效电平”是高电平。如果你希望默认输出低电平PWM有效段是低电平脉冲则选择Low。这个根据你的驱动电路决定。比如用PWM控制一个共阳极LED的阴极低电平才点亮那么这里就应该选Low这样占空比越大有效低电平时间越长LED越亮。其他保持默认点击Generate Code生成工程。3.2 生成的代码分析与用户代码集成打开生成的工程在tim.c文件中你可以找到MX_TIM3_Init函数。这个函数完成了定时器的基础配置包括时基单元和PWM通道的初始化。但注意它并没有启动定时器也没有开始输出PWM。要使PWM开始输出你需要在主循环开始前比如在main函数的while(1)之前添加两行关键代码/* 启动定时器3的通道2输出 */ HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_2); /* 如果需要在主循环中动态改变占空比 */ // __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, 新的CCR值);HAL_TIM_PWM_Start这个函数做了几件事使能定时器的计数器CNT开始计数并使能对应通道的输出比较预装载和输出使能。调用之后用示波器测量PB5引脚就应该能看到1kHz、50%占空比的PWM波了。如果你想动态调整占空比比如实现呼吸灯效果不要直接写htim3.Instance-CCR2 value而是使用HAL库提供的宏__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, value)。这个宏会操作CCRx的影子寄存器保证在安全的时间点更新占空比避免毛刺。3.3 关键配置项陷阱与避坑指南时钟树配置是源头前面计算PSC和ARR的前提是定时器时钟正确。务必在CubeMX的Clock Configuration标签页下确认系统时钟和各个总线时钟的配置与你计算时假设的一致。特别是APB1/APB2的预分频系数直接影响TIMxCLK。GPIO模式未配置为复用功能如果你手动编写代码或者CubeMX没有自动配置好一定要确保对应引脚如PB5的模式初始化为GPIO_MODE_AF_PP复用推挽输出。输出速度可以设为GPIO_SPEED_FREQ_MEDIUM或HIGH。没有启动定时器这是新手最常犯的错误。MX_TIMx_Init()只是初始化了硬件寄存器就像给汽车加满了油但没点火。必须调用HAL_TIM_PWM_Start()来“点火”。ARR或CCRx值为0如果ARR设为0那么PWM频率会极高CK_CNT / 1可能超出引脚响应能力波形异常。如果CCRx设为0在PWM模式1下输出将永远为无效电平占空比0%如果CCRx设置为大于ARR的值在向上计数模式下输出将永远为有效电平占空比100%。重映射功能未开启如果你使用的不是默认引脚比如想用PC7作为TIM3_CH2除了在CubeMX中选择对应的引脚还需要确认AFIO的重映射功能是否被正确使能。在标准库中需要调用GPIO_PinRemapConfig(GPIO_FullRemap_TIM3, ENABLE)。在HAL库生成的代码中检查__HAL_AFIO_REMAP_TIM3_ENABLE()类似的宏是否被调用。4. 进阶应用与波形调试技巧4.1 多通道同步输出与相位控制一个定时器的多个通道可以输出相同频率、不同占空比的PWM因为它们共享同一个ARR和PSC。这在控制RGB LED三色亮度或者多个需要同步的电机时非常有用。配置方法就是在CubeMX中使能多个通道如CH1, CH2, CH3然后分别设置各自的PulseCCRx值。在代码中用HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1 | TIM_CHANNEL_2 | TIM_CHANNEL_3)一次启动所有通道。更进阶一点你可以通过修改各个通道的“比较输出极性”和“预装载使能”并结合计数器的中央对齐模式来实现带相位差的PWM输出。例如在中央对齐模式下计数器先向上再向下计数可以产生对称的PWM波形常用于某些特定的电机驱动或数字电源拓扑。4.2 利用DMA自动更新占空比序列对于需要输出复杂PWM模式的应用比如生成特定形状的亮度曲线或驱动步进电机细分不断在中断里修改CCRx值会消耗大量CPU资源且时机难以精确控制。这时可以使用DMA。思路是将一组预先计算好的CCRx值存放在一个数组里配置DMA控制器让它在每次定时器更新事件UEV发生时自动将数组中的下一个值搬运到TIMx_CCRx寄存器中。这样PWM的占空比就会按照数组中的序列自动变化无需CPU干预。配置步骤稍复杂需要在CubeMX中开启TIMx的更新事件DMA请求并配置好DMA流内存到外设循环模式。这在生成正弦波PWMSPWM用于逆变器或高级灯光效果时是标准操作。4.3 示波器测量与常见波形问题排查当你连接好电路写入代码最激动人心的时刻就是上示波器看了。以下是一些常见问题及排查思路问题完全没有波形引脚一直是高电平或低电平。排查1检查引脚配置。确认GPIO已正确初始化为复用推挽输出。可以用万用表量一下引脚电压或者写个简单程序让引脚高低电平翻转测试引脚本身是否正常。排查2检查定时器启动。确认已调用HAL_TIM_PWM_Start()。排查3检查时钟。确认定时器时钟已使能CubeMX通常会自动生成__HAL_RCC_TIM3_CLK_ENABLE()。可以尝试将PWM频率设得很低如1Hz然后用LED接在引脚上看是否有缓慢的闪烁来定性判断是否有输出。排查4检查重映射。如果用了重映射引脚确认重映射代码已执行。问题有波形但频率或占空比不对。排查1核对计算。用示波器测出的周期T反算频率F1/T。与你的设计值对比。如果不符重新检查PSC和ARR的计算公式并确认TIMxCLK的值。记住公式Fpwm TIMxCLK / ((PSC1)*(ARR1))。排查2检查CCRx值。测量高电平时间T_high计算占空比 T_high / T。与CCRx/(ARR1)的理论值对比。检查代码中是否意外修改了CCRx寄存器。问题波形毛刺多上升沿/下降沿不干净。排查1负载问题。如果驱动的是感性负载如电机在PWM关断瞬间会产生反向电动势可能引起毛刺。需要在电机两端并联续流二极管。排查2电源噪声。检查MCU和驱动电路的电源是否稳定退耦电容0.1uF是否紧靠芯片电源引脚放置。排查3探头与接地。确保示波器探头接地良好尝试使用探头自带的接地弹簧而不是长接地夹可以减少测量引入的噪声。问题高级定时器TIM1/TIM8没有输出。特别注意高级定时器有一个MOE主输出使能位在刹车和死区控制禁用的情况下需要将其置1PWM输出才会有效。在HAL库中启动PWM后有时需要额外调用__HAL_TIM_MOE_ENABLE(htim1)。检查参考手册中关于TIMx_BDTR寄存器的描述。调试时养成“分步验证”的习惯。先确保最简单的GPIO输出正常再验证定时器基础计数可以用更新中断翻转一个测试引脚最后再开启PWM输出。这样一旦出现问题可以快速定位问题阶段。另外STM32CubeIDE的Debug模式非常好用你可以实时查看和修改定时器各个寄存器的值结合示波器波形是排查问题的利器。5. 从PWM到实际应用电机控制与LED调光5.1 直流有刷电机调速实战让我们把PWM用起来。假设我们要用TIM4的通道1PB6通过一个L298N电机驱动模块来控制一个直流小电机的转速。硬件连接STM32的PB6接L298N的ENA使能A引脚。L298N的IN1和IN2接MCU的两个普通IO用于控制方向正转/反转。电机接在L298N的OUT1和OUT2之间。L298N的电源和地要接好注意电机驱动电源和MCU逻辑电源最好隔离或共地处理得当。软件逻辑初始化TIM4输出PWM频率建议在1kHz到20kHz之间。频率太低电机会有啸叫太高了驱动芯片开关损耗大。10kHz是个常用起点。初始化两个方向控制IO比如PA1, PA2为推挽输出。设置方向正转时设置PA11, PA20反转时PA10, PA21。调速通过修改TIM4_CCR1的值来改变占空比。占空比越大ENA引脚的平均电压越高电机转速越快。// 设置方向为正转 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_SET); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET); // 设置速度为70% uint16_t target_pulse (uint16_t)(__HAL_TIM_GET_AUTORELOAD(htim4) * 0.7); __HAL_TIM_SET_COMPARE(htim4, TIM_CHANNEL_1, target_pulse);注意电机是感性负载在停止或快速调速时PWM关断瞬间会产生很高的反向电压。L298N内部有续流二极管但为了更可靠可以在电机两端额外并联一个RC吸收回路如100欧电阻串联0.1uF电容。同时电机电源和MCU电源之间建议使用磁珠或0欧电阻进行隔离并在靠近驱动芯片电源引脚处放置大容量如100uF电解电容和104瓷片电容进行退耦。5.2 实现平滑的LED呼吸灯效果呼吸灯是展示PWM占空比连续变化的经典应用。关键在于如何生成一个平滑变化的CCRx值序列。最简单的方法是使用线性递增/递减。// 假设htim3, CH2已配置为PWM输出并启动 uint16_t pwmVal 0; uint8_t dir 1; // 1:递增, 0:递减 while (1) { HAL_Delay(5); // 控制变化速度5ms改变一次值 if(dir 1) { pwmVal; if(pwmVal 500) { // 假设ARR是499最大占空比设为500对应100% dir 0; } } else { pwmVal--; if(pwmVal 0) { dir 1; } } __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, pwmVal); }但线性变化在人眼看来并不是均匀的因为人眼对光强的感知是非线性的近似对数关系。更专业的做法是使用“伽马校正”表或者使用正弦、余弦函数来生成变化值这样看起来的亮度变化会更加平滑自然。另外HAL_Delay()会阻塞CPU在实际产品中更好的做法是使用定时器中断在中断服务函数里更新CCRx值这样主循环可以处理其他任务。5.3 舵机控制一个特殊的PWM应用舵机控制虽然也是PWM但它对波形要求很特殊。常见的180度舵机控制信号是一个周期为20ms50Hz高电平脉冲宽度在0.5ms到2.5ms之间的PWM波。脉冲宽度对应着舵机的角度0.5ms对应0度2.5ms对应180度。因此配置定时器时频率要精确设置为50Hz。假设TIMxCLK72MHz那么ARR (72MHz / 50Hz) - 1 1,439,999。这超过了16位定时器的最大值65535。所以必须使用预分频器PSC来降低计数频率。我们可以先设定一个合适的ARR值比如19999这样产生50Hz信号72MHz / ((7191)*(199991)) 50Hz然后计算PSC719。那么0.5ms高电平对应的CCRx值 0.5ms / 20ms * (199991) 500。2.5ms对应的CCRx值 2.5ms / 20ms * 20000 2500。所以你的控制程序只需要将CCRx值设置在500到2500之间线性映射到0-180度即可。注意不同品牌舵机的中位脉冲可能略有差异有的是1.5ms需要根据数据手册调整。舵机控制对PWM的稳定性要求较高如果波形抖动舵机会吱吱叫甚至抖动。确保你的定时器时钟源稳定使用内部RC振荡器HSI可能会稍有偏差使用外部晶振HSE更佳并且避免在中断服务程序中进行复杂运算导致更新CCRx的时机出现较大抖动。
STM32定时器PWM配置全解析：从原理到电机控制实战
1. 项目概述从定时器到PWM的工程实践最近在调试一个电机控制板核心需求是用STM32F103的定时器输出一路频率和占空比都可调的PWM信号来驱动MOS管。听起来是个基础操作但实际动手时从定时器模式选择、通道配置到最终在示波器上看到干净稳定的方波中间还是有不少细节需要捋清楚。特别是对于刚从标准库转向HAL库或者习惯了某种固定配置模式的朋友换个项目换个需求可能又会遇到“为什么没有波形输出”这类经典问题。这篇文章我就以STM32F103C8T6这款经典的“蓝桥杯”芯片为例拆解一下如何使用其通用定时器TIM2, TIM3, TIM4来生成PWM。我会结合CubeMX配置和代码重点讲清楚背后的原理和那些容易踩坑的配置项目标是让你看完后不仅能配出来更能明白为什么要这么配遇到问题知道从哪里下手查。PWM脉宽调制说白了就是通过调节一个周期固定方波的“高电平时间”占整个周期的比例即占空比来等效地输出不同的“平均电压”。在嵌入式里它可是驱动电机调速、控制舵机转角、调节LED亮度呼吸灯的万金油。STM32F103的定时器功能强大其中通用定时器是产生PWM的主力。理解了这个你再去看高级定时器的互补输出、死区插入这些高级功能也会更有底气。2. 核心原理与硬件架构拆解2.1 STM32F103定时器家族与PWM能力概览STM32F103的定时器是个大家庭大体分三类基本定时器TIM6, TIM7、通用定时器TIM2, TIM3, TIM4, TIM5和高级定时器TIM1, TIM8。对于输出PWM这个任务我们主要关注通用定时器和高级定时器。基本定时器功能最简单只能向上计数通常用于单纯的时基或者DAC触发它没有输出比较功能所以不能直接产生PWM。这一点首先要明确别在TIM6/TIM7上浪费时间找PWM输出引脚。通用定时器是我们今天的主角。以TIM2/TIM3/TIM4为例它们都是16位向上、向下或向上/向下中央对齐计数模式每个定时器有4个独立的通道TIM2和TIM5是32位的但通道数也是4个每个通道都可以被配置为输入捕获、输出比较或者PWM输出模式。当配置为PWM模式时定时器会根据计数器CNT的值和捕获/比较寄存器CCRx的值进行比较从而在对应的输出引脚上产生电平跳变形成PWM波形。通用定时器功能全面足以应对大多数PWM应用场景如LED调光、蜂鸣器驱动、简易电机调速等。高级定时器TIM1/TIM8在通用定时器的基础上增加了互补输出、死区插入、刹车功能等专门为电机控制和电源应用设计。如果你需要驱动三相电机、或者需要防止上下桥臂直通那就必须用到高级定时器的这些高级特性。但它的基础PWM生成原理和通用定时器是一致的。选择哪个定时器第一看引脚是否方便第二看功能是否满足。例如TIM2的通道1CH1对应PA0但PA0常常用作唤醒引脚WKUP如果项目要用到唤醒功能这个引脚就可能冲突。所以在CubeMX里分配引脚时要有全局观。2.2 PWM生成的底层逻辑比较与匹配理解PWM如何产生关键在于理解定时器的两个核心寄存器自动重装载寄存器ARR和捕获/比较寄存器CCRx。你可以把定时器想象成一个不断循环的沙漏。ARR决定了这个沙漏的“容量”也就是PWM的周期。计数器CNT就像沙漏里的沙子从0开始一粒一粒增加向上计数。CCRx则是一个我们预设的“刻度线”。定时器的工作流程是这样的时钟源驱动内部时钟APB总线时钟经过分频或倍频驱动着计数器CNT递增。比较与输出在每个时钟周期硬件都会比较CNT的值和CCRx的值。在PWM模式1下通常的规则是当CNT CCRx时输出有效电平高或低可配置当CNT CCRx且CNT ARR时输出无效电平。周期重置当CNT计数到ARR的值时产生一个“更新事件”UEVCNT被硬件清零向上计数模式然后开始下一个计数周期。如此周而复始。所以ARR决定了PWM的频率周期CCRx决定了PWM的占空比。频率Fpwm 定时器时钟频率 / ((ARR 1) * (PSC 1))。其中PSC是预分频器寄存器用于降低计数时钟频率以适应更低的PWM频率需求。占空比Duty CCRx / (ARR 1)。这里有个关键点ARR和CCRx都是16位寄存器对于通用定时器最大值65535。在计算频率和设置占空比时我们通常操作的是ARR和CCRx的“影子寄存器”通过__HAL_TIM_SET_AUTORELOAD()和__HAL_TIM_SET_COMPARE()这类宏或函数来设置硬件会在下一个更新事件时自动将影子寄存器的值加载到实际工作的寄存器中这样可以避免在周期中间修改参数导致波形出现毛刺。2.3 引脚复用与硬件连接要点STM32的引脚功能是复用的一个PA8引脚既可以是普通GPIO也可以是TIM1的通道1还可能是USART1的CK线。因此使用定时器输出PWM必须将对应引脚配置为复用推挽输出模式Alternate Function Push-Pull。以TIM3的通道2CH2为例它可能映射到PB5默认或者PC7重映射。你需要在芯片数据手册的“引脚定义”章节或CubeMX的引脚分配图中确认。在CubeMX中你直接点击对应定时器通道选择“PWM Generation CHx”软件会自动帮你把引脚模式配置好。注意STM32F103的定时器引脚有部分重映射和完全重映射功能通过AFIO寄存器控制。在标准库中需要手动调用GPIO_PinRemapConfig函数。在HAL库配合CubeMX时如果使用了重映射引脚CubeMX通常会自动生成AFIO配置代码但最好在生成的MX_TIMx_Init()函数附近检查一下确保重映射代码已生效。硬件连接上PWM输出引脚直接驱动LED或通过限流电阻驱动三极管基极是没问题的。但如果要驱动电机尤其是直流有刷电机或舵机通常需要接一个电机驱动芯片如L298N、TB6612等。PWM信号接到驱动芯片的使能或输入引脚通过改变PWM占空比来控制电机两端的平均电压从而实现调速。绝对不要试图用MCU的IO口直接驱动电机电流不够还会损坏单片机。3. 基于CubeMX与HAL库的配置实战理论讲完了我们动手配一个。目标使用TIM3的通道2PB5引脚输出一个频率为1kHz占空比为50%的PWM信号。3.1 CubeMX工程初始化与定时器参数计算首先在CubeMX中创建新工程选择你的芯片型号如STM32F103C8Tx。在Pinout Configuration视图下在左侧分类中找到Timers展开并选中TIM3。在下方配置面板将Clock Source设为Internal Clock内部时钟。找到Channel2选择PWM Generation CH2。此时右侧的原理图上PB5引脚应该会被自动标记为TIM3_CH2。接下来是关键参数计算在Parameter Settings标签页Prescaler (PSC - 预分频器)这个值决定了定时器计数时钟CK_CNT的频率。CK_CNT TIMxCLK / (PSC 1)。TIM3挂载在APB1总线上APB1的时钟频率默认是系统时钟72MHz的一半即36MHz。但注意如果APB1预分频系数不为1定时器时钟会倍频x2。在默认的72MHz系统时钟、APB1预分频器为2的配置下APB1时钟是36MHz而TIM3的时钟TIMxCLK是72MHz。我们假设系统时钟为72MHz且TIM3时钟为72MHz。 为了得到1kHz的PWM我们先设定一个目标计数频率。假设我们让ARR设为999那么CK_CNT Fpwm * (ARR1) 1kHz * 1000 1MHz。 因此PSC (TIMxCLK / CK_CNT) - 1 (72MHz / 1MHz) - 1 71。在CubeMX中填入71。Counter Mode (计数模式)选择Up向上计数。这是最常用的模式。Counter Period (ARR - 自动重装载值)根据上面计算我们想要1000个计数周期所以ARR 1000 - 1 999。填入999。auto-reload preload (自动重载预装载)建议使能Enable。这对应着ARR的影子寄存器功能。使能后你修改ARR的值不会立即生效而是等到下一个更新事件这样可以避免在PWM周期中间更新周期值导致波形错乱。PWM Generation Channel 2 子配置Mode (模式)选择PWM mode 1。在这个模式下当CNT CCRx时输出有效电平CNT CCRx时输出无效电平。Pulse (CCR2 - 脉冲值)这个就是占空比对应的CCRx值。占空比50%即CCR2 (ARR 1) * 50% 1000 * 0.5 500。填入500。Fast Mode (快速模式)禁用。这个模式用于在CCRx与CNT匹配时强制输出反转而不是等到下一个周期。在普通PWM应用中不需要。CH Polarity (通道极性)选择High。这意味着“有效电平”是高电平。如果你希望默认输出低电平PWM有效段是低电平脉冲则选择Low。这个根据你的驱动电路决定。比如用PWM控制一个共阳极LED的阴极低电平才点亮那么这里就应该选Low这样占空比越大有效低电平时间越长LED越亮。其他保持默认点击Generate Code生成工程。3.2 生成的代码分析与用户代码集成打开生成的工程在tim.c文件中你可以找到MX_TIM3_Init函数。这个函数完成了定时器的基础配置包括时基单元和PWM通道的初始化。但注意它并没有启动定时器也没有开始输出PWM。要使PWM开始输出你需要在主循环开始前比如在main函数的while(1)之前添加两行关键代码/* 启动定时器3的通道2输出 */ HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_2); /* 如果需要在主循环中动态改变占空比 */ // __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, 新的CCR值);HAL_TIM_PWM_Start这个函数做了几件事使能定时器的计数器CNT开始计数并使能对应通道的输出比较预装载和输出使能。调用之后用示波器测量PB5引脚就应该能看到1kHz、50%占空比的PWM波了。如果你想动态调整占空比比如实现呼吸灯效果不要直接写htim3.Instance-CCR2 value而是使用HAL库提供的宏__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, value)。这个宏会操作CCRx的影子寄存器保证在安全的时间点更新占空比避免毛刺。3.3 关键配置项陷阱与避坑指南时钟树配置是源头前面计算PSC和ARR的前提是定时器时钟正确。务必在CubeMX的Clock Configuration标签页下确认系统时钟和各个总线时钟的配置与你计算时假设的一致。特别是APB1/APB2的预分频系数直接影响TIMxCLK。GPIO模式未配置为复用功能如果你手动编写代码或者CubeMX没有自动配置好一定要确保对应引脚如PB5的模式初始化为GPIO_MODE_AF_PP复用推挽输出。输出速度可以设为GPIO_SPEED_FREQ_MEDIUM或HIGH。没有启动定时器这是新手最常犯的错误。MX_TIMx_Init()只是初始化了硬件寄存器就像给汽车加满了油但没点火。必须调用HAL_TIM_PWM_Start()来“点火”。ARR或CCRx值为0如果ARR设为0那么PWM频率会极高CK_CNT / 1可能超出引脚响应能力波形异常。如果CCRx设为0在PWM模式1下输出将永远为无效电平占空比0%如果CCRx设置为大于ARR的值在向上计数模式下输出将永远为有效电平占空比100%。重映射功能未开启如果你使用的不是默认引脚比如想用PC7作为TIM3_CH2除了在CubeMX中选择对应的引脚还需要确认AFIO的重映射功能是否被正确使能。在标准库中需要调用GPIO_PinRemapConfig(GPIO_FullRemap_TIM3, ENABLE)。在HAL库生成的代码中检查__HAL_AFIO_REMAP_TIM3_ENABLE()类似的宏是否被调用。4. 进阶应用与波形调试技巧4.1 多通道同步输出与相位控制一个定时器的多个通道可以输出相同频率、不同占空比的PWM因为它们共享同一个ARR和PSC。这在控制RGB LED三色亮度或者多个需要同步的电机时非常有用。配置方法就是在CubeMX中使能多个通道如CH1, CH2, CH3然后分别设置各自的PulseCCRx值。在代码中用HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1 | TIM_CHANNEL_2 | TIM_CHANNEL_3)一次启动所有通道。更进阶一点你可以通过修改各个通道的“比较输出极性”和“预装载使能”并结合计数器的中央对齐模式来实现带相位差的PWM输出。例如在中央对齐模式下计数器先向上再向下计数可以产生对称的PWM波形常用于某些特定的电机驱动或数字电源拓扑。4.2 利用DMA自动更新占空比序列对于需要输出复杂PWM模式的应用比如生成特定形状的亮度曲线或驱动步进电机细分不断在中断里修改CCRx值会消耗大量CPU资源且时机难以精确控制。这时可以使用DMA。思路是将一组预先计算好的CCRx值存放在一个数组里配置DMA控制器让它在每次定时器更新事件UEV发生时自动将数组中的下一个值搬运到TIMx_CCRx寄存器中。这样PWM的占空比就会按照数组中的序列自动变化无需CPU干预。配置步骤稍复杂需要在CubeMX中开启TIMx的更新事件DMA请求并配置好DMA流内存到外设循环模式。这在生成正弦波PWMSPWM用于逆变器或高级灯光效果时是标准操作。4.3 示波器测量与常见波形问题排查当你连接好电路写入代码最激动人心的时刻就是上示波器看了。以下是一些常见问题及排查思路问题完全没有波形引脚一直是高电平或低电平。排查1检查引脚配置。确认GPIO已正确初始化为复用推挽输出。可以用万用表量一下引脚电压或者写个简单程序让引脚高低电平翻转测试引脚本身是否正常。排查2检查定时器启动。确认已调用HAL_TIM_PWM_Start()。排查3检查时钟。确认定时器时钟已使能CubeMX通常会自动生成__HAL_RCC_TIM3_CLK_ENABLE()。可以尝试将PWM频率设得很低如1Hz然后用LED接在引脚上看是否有缓慢的闪烁来定性判断是否有输出。排查4检查重映射。如果用了重映射引脚确认重映射代码已执行。问题有波形但频率或占空比不对。排查1核对计算。用示波器测出的周期T反算频率F1/T。与你的设计值对比。如果不符重新检查PSC和ARR的计算公式并确认TIMxCLK的值。记住公式Fpwm TIMxCLK / ((PSC1)*(ARR1))。排查2检查CCRx值。测量高电平时间T_high计算占空比 T_high / T。与CCRx/(ARR1)的理论值对比。检查代码中是否意外修改了CCRx寄存器。问题波形毛刺多上升沿/下降沿不干净。排查1负载问题。如果驱动的是感性负载如电机在PWM关断瞬间会产生反向电动势可能引起毛刺。需要在电机两端并联续流二极管。排查2电源噪声。检查MCU和驱动电路的电源是否稳定退耦电容0.1uF是否紧靠芯片电源引脚放置。排查3探头与接地。确保示波器探头接地良好尝试使用探头自带的接地弹簧而不是长接地夹可以减少测量引入的噪声。问题高级定时器TIM1/TIM8没有输出。特别注意高级定时器有一个MOE主输出使能位在刹车和死区控制禁用的情况下需要将其置1PWM输出才会有效。在HAL库中启动PWM后有时需要额外调用__HAL_TIM_MOE_ENABLE(htim1)。检查参考手册中关于TIMx_BDTR寄存器的描述。调试时养成“分步验证”的习惯。先确保最简单的GPIO输出正常再验证定时器基础计数可以用更新中断翻转一个测试引脚最后再开启PWM输出。这样一旦出现问题可以快速定位问题阶段。另外STM32CubeIDE的Debug模式非常好用你可以实时查看和修改定时器各个寄存器的值结合示波器波形是排查问题的利器。5. 从PWM到实际应用电机控制与LED调光5.1 直流有刷电机调速实战让我们把PWM用起来。假设我们要用TIM4的通道1PB6通过一个L298N电机驱动模块来控制一个直流小电机的转速。硬件连接STM32的PB6接L298N的ENA使能A引脚。L298N的IN1和IN2接MCU的两个普通IO用于控制方向正转/反转。电机接在L298N的OUT1和OUT2之间。L298N的电源和地要接好注意电机驱动电源和MCU逻辑电源最好隔离或共地处理得当。软件逻辑初始化TIM4输出PWM频率建议在1kHz到20kHz之间。频率太低电机会有啸叫太高了驱动芯片开关损耗大。10kHz是个常用起点。初始化两个方向控制IO比如PA1, PA2为推挽输出。设置方向正转时设置PA11, PA20反转时PA10, PA21。调速通过修改TIM4_CCR1的值来改变占空比。占空比越大ENA引脚的平均电压越高电机转速越快。// 设置方向为正转 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_SET); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET); // 设置速度为70% uint16_t target_pulse (uint16_t)(__HAL_TIM_GET_AUTORELOAD(htim4) * 0.7); __HAL_TIM_SET_COMPARE(htim4, TIM_CHANNEL_1, target_pulse);注意电机是感性负载在停止或快速调速时PWM关断瞬间会产生很高的反向电压。L298N内部有续流二极管但为了更可靠可以在电机两端额外并联一个RC吸收回路如100欧电阻串联0.1uF电容。同时电机电源和MCU电源之间建议使用磁珠或0欧电阻进行隔离并在靠近驱动芯片电源引脚处放置大容量如100uF电解电容和104瓷片电容进行退耦。5.2 实现平滑的LED呼吸灯效果呼吸灯是展示PWM占空比连续变化的经典应用。关键在于如何生成一个平滑变化的CCRx值序列。最简单的方法是使用线性递增/递减。// 假设htim3, CH2已配置为PWM输出并启动 uint16_t pwmVal 0; uint8_t dir 1; // 1:递增, 0:递减 while (1) { HAL_Delay(5); // 控制变化速度5ms改变一次值 if(dir 1) { pwmVal; if(pwmVal 500) { // 假设ARR是499最大占空比设为500对应100% dir 0; } } else { pwmVal--; if(pwmVal 0) { dir 1; } } __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, pwmVal); }但线性变化在人眼看来并不是均匀的因为人眼对光强的感知是非线性的近似对数关系。更专业的做法是使用“伽马校正”表或者使用正弦、余弦函数来生成变化值这样看起来的亮度变化会更加平滑自然。另外HAL_Delay()会阻塞CPU在实际产品中更好的做法是使用定时器中断在中断服务函数里更新CCRx值这样主循环可以处理其他任务。5.3 舵机控制一个特殊的PWM应用舵机控制虽然也是PWM但它对波形要求很特殊。常见的180度舵机控制信号是一个周期为20ms50Hz高电平脉冲宽度在0.5ms到2.5ms之间的PWM波。脉冲宽度对应着舵机的角度0.5ms对应0度2.5ms对应180度。因此配置定时器时频率要精确设置为50Hz。假设TIMxCLK72MHz那么ARR (72MHz / 50Hz) - 1 1,439,999。这超过了16位定时器的最大值65535。所以必须使用预分频器PSC来降低计数频率。我们可以先设定一个合适的ARR值比如19999这样产生50Hz信号72MHz / ((7191)*(199991)) 50Hz然后计算PSC719。那么0.5ms高电平对应的CCRx值 0.5ms / 20ms * (199991) 500。2.5ms对应的CCRx值 2.5ms / 20ms * 20000 2500。所以你的控制程序只需要将CCRx值设置在500到2500之间线性映射到0-180度即可。注意不同品牌舵机的中位脉冲可能略有差异有的是1.5ms需要根据数据手册调整。舵机控制对PWM的稳定性要求较高如果波形抖动舵机会吱吱叫甚至抖动。确保你的定时器时钟源稳定使用内部RC振荡器HSI可能会稍有偏差使用外部晶振HSE更佳并且避免在中断服务程序中进行复杂运算导致更新CCRx的时机出现较大抖动。
