简介STM32 HAL库PWM输出程序是一套基于定时器TIM的入门工程面向刚接触STM32CubeMX与HAL库的开发者覆盖从图形化配置到HAL函数调用的完整流程帮助解决PWM输出从外设配置到代码调用的核心问题。压缩包共73个文件包含46个.h头文件、19个.c源文件以及.ioc图形化工程配置、.uvprojx MDK工程、.hex烧录文件、.bat清理脚本和.s启动文件整体大小仅517KB目录精简、便于快速导入实验。目前已有8834人浏览学习适合作为PWM调光、电机调速等场景的参考起点。工程内提供标准HAL库分层代码覆盖定时器PWM初始化、通道比较值设置、启动停止及更新中断处理等关键步骤同时保留CubeMX配置可对照查看预分频、自动重装载值与占空比调整方法也能直接修改参数验证不同PWM输出效果此外还配有清理脚本便于整理工程目录为后续多通道PWM、死区控制等进阶应用打下基础。 记得几年前我第一次在F103C8T6上点PWM板子用的是最小系统板LED接在PA0上我照着例程一行行敲最后看到呼吸灯亮起来的时候还挺激动。后来做电机驱动、舵机云台、DCDC反馈补偿才发现PWM这个东西简单是简单但真要做得稳、做得准里面全是细节。这篇博客算是一个从入门到工程化的梳理STM32的HAL库PWM输出程序到底该怎么写、怎么配、怎么排查问题。PWMPulse Width Modulation脉冲宽度调制说白了就是让引脚按固定频率输出高和低通过改变高电平在一个周期里的占比占空比来模拟不同的“有效值”。它不是真的输出一个可变电压而是靠开关速度足够快让负载“感觉”到的是平均值。比如LED调光拿1kHz的方波占空比30%肉眼看过去就是三成亮度直流电机更是这样平均电压降下来转速自然就降了。HAL库是ST官方为了统一不同MCU家族操作而推出的硬件抽象层配合CubeMX自动初始化能帮你省掉大量底层寄存器配置的体力活。这篇文章面向刚接触STM32的初学者也适合一直用寄存器或标准库、想转HAL库的朋友。1. 整体设计思路从原理到方案选型1.1 PWM的核心概念频率、占空比与一个调光台灯的类比PWM有两个关键参数频率和占空比。频率决定开关快慢占空比决定一个周期里高电平的比例。可以把它想象成调光台灯你手拧旋钮的过程就是在不断改变占空比——如果开关频率太低比如1Hz灯泡会明显闪烁频率高于人眼感知范围后看起来就是稳定的亮度。实际项目里LED调光一般选1kHz到10kHz既能避开闪烁又不会因为频率太高引入额外干扰直流电机常用10kHz到20kHz目的之一是躲开人耳最敏感的2kHz到5kHz可听噪声。在STM32上产生PWM本质就是让定时器工作在PWM模式一个计数器CNT从0数到ARR自动重装载值再回到0不断循环。在这个循环过程中拿CNT和CCR捕获比较寄存器比较CNT小于CCR输出高CNT大于等于CCR输出低这就是PWM模式1的经典行为。所以频率由定时器时钟、PSC预分频和ARR共同决定占空比则由CCR和ARR的相对关系决定。理解了这条链路后面所有计算都不会跑偏。1.2 为什么推荐HAL库加CubeMX以及什么时候该放弃HAL库最大的价值不是性能而是可读性和可移植性。你用CubeMX选好引脚、时钟、定时器参数自动生成初始化代码应用层只需要调用几个API项目交接和后期维护都轻松得多。即便跨到G0、L4这些新型号熟悉HAL之后的学习成本也低。它付出的代价是代码体积和一点运行效率但对绝大多数PWM应用来说这点开销可以忽略不计。当然HAL也不是银弹。如果做高频电源、电机FOC这类对时序精度和效率极度敏感的东西我建议直接操作寄存器或者至少在关键路径上绕开HAL的封装。HAL库的定时器接口在连续高频中断下会有抖动而且很多地方调用会有断言检查和多余判断实时性要求严格时你会很头疼。所以我的观点是学习用HAL、量产评估用HAL、性能卡脖子了再针对性优化。1.3 定时器选型F103上的PWM资源盘点以最常用的STM32F103C8T6为例这颗芯片有TIM1、TIM2、TIM3、TIM4四个能输出PWM的定时器。TIM1是高级定时器挂在APB2上支持互补输出、刹车输入、死区插入适合驱动三相全桥或H桥的上下管TIM2、TIM3、TIM4是通用定时器挂在APB1上每路相互独立。如果工程里同时要控制4路舵机和2路电机定时器资源就得提前规划选型时先看通道数够不够再看是否要互补、刹车等功能不要到了画板子才发现通道冲突。这里提醒一句某些大容量型号还有TIM8高级、TIM15、TIM16、TIM17等但F103C8T6没有。遇到具体芯片最稳妥的办法是打开CubeMX里面哪个定时器、哪个通道能用是灰色的还是彩色的一看便知。2. 核心细节解析时钟、寄存器与API2.1 定时器时钟树APB1和APB2的倍数关系定时器的时钟源不是固定值它由时钟树决定。F103系统主频72MHz时APB2一般设成72MHzAPB1设成36MHz两个总线都有一个“定时器时钟倍频”机制只要总线预分频器不是1则挂在它下面的定时器时钟就是总线时钟的2倍。很多人第一次用CubeMX看时钟树会蒙明明选了PSC71怎么频率还是不对多半就是没搞清楚这个2倍关系。在CubeMX里RCC配置好之后定时器时钟在Clock Configuration页直接显示。拿F103C8T6默认配置来说TIM1的时钟是72MHzTIM2、TIM3、TIM4的时钟也是72MHz因为APB1分频后倍频回来。做计算时不要用APBx总线频率而是用定时器时钟这个细节点我每次给新手讲都会强调一遍。2.2 频率与占空比计算两个寄存器搞定PWM输出频率的公式是f TIMxCLK / ((PSC1) * (ARR1))占空比 CCR / (ARR1) * 100%这里PSC、ARR、CCR都是16位寄存器最大只能写65535。举一个实际例子我要用TIM2产生1kHz、50%占空比PWMTIM2CLK72MHz。选PSC71则计数频率为72MHz/721MHz再让ARR999这样定时器从0数到999一共1000个计数周期刚好1kHz。占空比50%CCR设成500。如果PSC0ARR72000-1也可以得到1kHz但ARR最大只能到65535所以72000会超限必须拆给PSC一部分。这种拆分技巧在需要精确频率时很重要建议优先让PSC满足分频需求再倒推ARR。2.3 HAL库PWM常用API和宏用到烂熟于心的几个HAL库PWM操作的核心函数真不多HAL_TIM_PWM_Start(htim2, TIM_CHANNEL_1)启动PWM输出。注意一定要传对定时器和通道很多新手只写了前半句发现引脚没波形。HAL_TIM_PWM_Stop(htim2, TIM_CHANNEL_1)停止输出。停止后引脚电平是低还是高取决于GPIO配置和空闲状态。__HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, ccr)运行时改占空比这个宏在代码里用得最多。__HAL_TIM_SET_AUTORELOAD(htim2, arr)运行时改频率。如果用的是TIM1这类高级定时器老版本HAL或某些开发者封装的代码里需要额外使能主输出MOE位不然PWM死活不出来。新版HAL的HAL_TIM_PWM_Start已经帮你处理了但如果你自己封装底层看到只有高级定时器没输出的时候第一个检查项就应该是MOE。3. 实操过程CubeMX配置与代码实现3.1 CubeMX五步配置PWM输出第一步在Pinout视图里选中目标引脚点击鼠标切换成TIMx_CHx功能。例如TIM2_CH1对应PA0。不手动选通道也没关系CubeMX会在配置定时器时自动把引脚占用。第二步在Timers里打开TIM2选Channel1 PWM Generation CHx。第三步配置PSC、ARR、Pulse三个关键参数。Pulse就是初始CCR值比如先给0让LED上电不亮。第四步在Project Manager里选择工具链MDK-ARM生成初始化代码。第五步在生成的main.c里调用PWM启动函数。一个容易忽略的细节是GPIO的复用配置。CubeMX生成的代码已经帮我们把PA0设成复用推挽输出但如果你手写代码漏掉这一步引脚不会出波形。遇到“程序明明启动了示波器却什么都没看到”先去看GPIO设置。3.2 呼吸灯让LED像手机呼吸灯一样渐变呼吸灯本质就是不断连续改变CCR让LED亮度从暗变亮、再慢慢变暗。频率建议选1kHz以上防止肉眼看到闪烁。下面这段代码是我在生成工程基础上直接改的#define PWM_PERIOD 999 // ARR uint16_t brightness 0; int8_t dir 1; while (1) { __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, brightness); HAL_Delay(5); brightness dir; if (brightness PWM_PERIOD) dir -1; else if (brightness 0) dir 1; }这样亮度线性加减效果很丝滑。如果觉得线性渐变不够细腻可以预先算好一个正弦表周期性地把CCR写成表里对应值呼吸曲线会自然很多。正弦表在Flash上占不了多少空间算一次写死即可。3.3 舵机控制用50Hz PWM驱动SG90舵机是PWM应用里非常典型的场景。标准舵机比如SG90的舵机柱角度由高电平脉宽决定周期固定20ms50Hz脉宽0.5ms对应0度1.5ms对应90度2.5ms对应180度。用TIM2CLK72MHzPSC719得到100kHz计数频率ARR1999这样计数周期是2000对应20ms频率正好50Hz。脉宽0.5ms对应的CCR是502.5ms对应250所以角度换算公式大约是CCR (角度/180)*200 50。#define SERVO_MIN_CCR 50 #define SERVO_MAX_CCR 250 void servo_set_angle(TIM_HandleTypeDef *htim, uint32_t ch, uint8_t angle) { if (angle 180) angle 180; uint16_t ccr SERVO_MIN_CCR (uint16_t)((uint32_t)angle * 200 / 180); __HAL_TIM_SET_COMPARE(htim, ch, ccr); }这里我用了整数运算避免浮点MCU跑起来更快。实测SG90对脉宽精度要求不高误差几个微秒也看不出来关键是周期要稳定在20ms附近别用HAL_Delay在主循环里慢慢拖拖完周期就飘了。3.4 直流电机调速PWM配合H桥的简单思路直流电机的平均电压由占空比决定所以调速的核心就是改CCR。方向控制离不开H桥单向调速可以只用一个PWM通道双向需要两个PWM引脚配合逻辑控制。频率选10kHz到20kHz太低会听到电机线圈发出的啸叫太高H桥开关损耗会变大。实际项目中电机两端尽量不要长时间100%占空比驱动。一方面制动特性差另一方面电感续流对H桥压力大。一般我会留5%到10%的余量最高给到90%左右。如果驱动的是带霍尔编码器的直流电机可以先把PWM频率固定再用PID闭环调整CCR这一块已经超出本文范围但思路是相通的。4. 常见问题与排查技巧实录4.1 PWM完全没有输出从CubeMX到硬件的排查顺序PWM没输出是新手遇到最多的问题我总结一个排查顺序先看CubeMX工程里对应定时器Mode是否真的选了PWM Generation再看生成的代码中GPIO是否配置成了复用推挽然后确认在main中调用了HAL_TIM_PWM_Start最后用示波器量引脚电平。如果以上都正常检查是不是用到了高级定时器TIM1或TIM8老版本HAL要手动使能MOE。还有一个颇为隐蔽的点如果你在CubeMX里把定时器的周期设成了0ARR0计数器一加载就翻转自然看不到标准方波。ARR至少要比CCR大或者说至少大于等于1才能输出完整PWM周期。4.2 频率不准确时钟配置的隐蔽坑频率不准确十有八九是时钟配置问题。CubeMX默认用的可能是HSI内部8MHz而不是外部晶振HSE。如果板子外接8MHz晶振但RCC配置里还停留在HSI主频只有8MHz算出来的PWM频率自然差一大截。打开Clock Configuration看一眼系统时钟是不是72MHzAPB1、APB2预分频是不是按需分配。另一种可能是PSC和ARR计算溢出。如果你算出来的ARR超过65535要么降低PSC要么换更高主频的芯片不要硬塞进去寄存器会截断出来的频率完全不对。这也可以用C语言提前算好范围再填别靠肉眼去估。4.3 占空比改了没反应几个容易忽略的细节改占空比没反应先确认用的是__HAL_TIM_SET_COMPARE而不是只改了某个局部变量。其次确认传入的通道和启动时一致比如启动的是TIM_CHANNEL_1却在改TIM_CHANNEL_2那当然没变化。然后看CCR数值是否在0到ARR之间如果CCR大于ARR输出会一直高或一直低表现为占空比“卡死”。还要注意PWM模式下CCR寄存器是带影子寄存器的也就是说写进去的值要等一次更新事件才会真正生效。HAL的__HAL_TIM_SET_COMPARE实际是写TIMx-CCR1寄存器在PWM模式中通常下一次计数周期开始时自动加载所以不会有“改完要等很久”的问题。但如果改了ARR最好调用__HAL_TIM_GENERATE_UPDATE强制刷新一次避免奇怪现象。4.4 常见问题速查表现象可能原因排查优先级引脚无波形定时器未启动、GPIO未配复用、未使能MOE高频率差很多系统主频不对、PSC或ARR溢出高占空比不变改错通道、CCR超出范围、逻辑写错中波形毛刺大电源噪声、线材过长、GPIO驱动能力中舵机抖动周期不稳定、电源不足、更新CCR太频繁中电机啸叫PWM频率落入音频范围低遇到波形毛刺先看示波器探头地线夹是不是夹得够近这是很多人忽略的测量问题不一定真是板子上的噪声。电源纹波大也会在PWM边缘叠加明显的毛刺必要时在电机或舵机电源处加一个100uF电解电容和0.1uF陶瓷电容。最后再分享一个我自己用下来的习惯无论多简单的PWM项目我都会在初始化之后用示波器先量一遍频率和占空比确认了再写应用逻辑。原因是PWM参数一旦错了后面整套控制逻辑全是错的而且排查起来特别费时间。另外建议把定时器通道、PSC、ARR、频率这些关键参数写在代码文件头部注释里方便后面维护。就这样去点亮你的第一路PWM吧。本文还有配套的精品资源点击获取