简介这套压缩包以STC12C2052单片机为核心完整演示了利用PWM脉宽调制技术调节LED灯亮度的过程面向单片机初学者和电子爱好者用于学习无级调光、占空比概念及PWM模块配置。包内共55个文件以C源码、Keil工程.uv2、编译生成的hex固件及各类备份文件为主rar压缩后仅44KB小巧方便可直接导入Keil查看或烧录验证。目前已有813人学习其中既有基础PWM调光例程也有键盘、显示、自动控制等多个功能模块的工程代码便于对比不同实现方式。通过修改占空比参数可以直观看到LED亮度从暗到亮的连续变化同时理解STC12C2052内置PWM模块无需额外硬件即可输出可调方波的硬件特性。这套资料可作为室内照明调光、指示灯亮度控制等新手项目的起步参考既能训练C语言编程也能掌握单片机定时器与PWM协同工作的调试方法。 我最早接触LED调光的时候脑子里想到的第一个方案就是串电阻。后来做项目甲方要求亮度连续可调还得低发热、不闪、寿命不缩水才发现“高频开关”比“线性限流”聪明得多。PWM脉冲宽度调制本质上不是在调电流而是在调导通时间占比——LED在高频亮灭之间切换人眼感受到的是平均亮度。这篇文章我就以STM32F103ZET6的TIM3为例把PWM调光的原理、引脚配置、代码实现和实测中容易踩的坑完整讲一遍。适合手里有开发板、想从“点灯”进阶到“调光”的读者也适合准备用PWM驱动LED或电机、但对占空比和频率还没完全理清思路的朋友。1. 为什么PWM是LED调光的“最优解”原理里藏着答案1.1 线性降压调光的三个短板很多新手会问LED亮度不是可以用电阻限流吗我做个小夜灯串电阻能调光为什么非要上PWM我实际对比过线性方案有三个绕不开的问题。第一个是效率。电阻降压的原理是消耗多余能量电流越大发热越狠。用电池供电的小设备电阻上白白烧掉的热量直接决定了续航时间。第二个问题是色温漂移。LED的色温会随电流变化你用电流方式调光低亮度下灯会明显发黄、发暗而PWM调光让LED始终工作在其额定的电流区间色温和光谱基本不漂。第三个问题是失控区。很多LED在低于某阈值电流后直接不亮或者严重非线性导致暗部调光根本没法用。而PWM调光相当于在“全亮”和“熄灭”之间切理论上可以实现从0%到100%的完整调节范围。所以工程上真正被大量使用的方案是让LED工作在额定的峰值电流下再用PWM控制导通时间占比也就是占空比。LED的响应速度是微秒级别的远快于开关切换速度所以每一次导通、截止都干净利落没有拖泥带水的过渡区。1.2 占空比、频率、分辨率三个参数怎么互相牵制PWM有三个核心参数频率、占空比、分辨率。很多人只知道占空比越大灯越亮但另外两个参数才是真正决定调光效果的关键。占空比就是高电平时间占整个周期的比例。50%占空比下LED的理论平均亮度就是额定亮度的50%。频率决定了开关快慢一般至少要高于1kHz否则不仅肉眼能感受到闪烁长时间在这种光下工作眼睛也容易疲劳。分辨率则取决于PWM周期被分成了多少份也就是ARR值。ARR999时占空比可以做到0.1%步进也就是约10位分辨率ARR4999时步进是0.02%约12位。人眼对亮度分辨能力有限实际灯具做到10~12位已经非常平滑盲目堆分辨率只会让程序计算变重没有太多感知上的收益。这三个参数不是独立的它们被定时器主频锁在一起。在STM32F103上TIM3的时钟默认是72MHz计算公式是PWM频率 72MHz / ((PSC 1) × (ARR 1))我希望PWM频率为20kHz并获得约1200级的分辨率那么PSC和ARR的乘积应为3600。我常用的组合是PSC2、ARR1199算出来正好是72MHz / (3 × 1200) 20kHz。实际计算时不必追求完美整数只要对亮度没有特殊要求差几百赫兹完全无感。但要注意这个计算是基于“APB1定时器时钟已经倍频到72MHz”的前提STM32CubeMX默认配置下APB1外设时钟是36MHz但定时器时钟会自动倍频到72MHz不少人在手动配置时会在这里少乘一个2导致PWM实际频率只有预期的一半。这是一个非常隐蔽的坑后面实测排查部分我还会提到。2. 从引脚规划到CubeMX配置让TIM3先输出一路PWM2.1 为什么我只选TIM3而不是TIM1/高级定时器网上很多教程上来就用TIM1做PWM理由是“高级定时器功能更强”。但LED调光这件事普通定时器和高级定时器做出来的效果没有任何区别反而TIM1/TIM8还有很多额外寄存器需要处理比如刹车输入、互补输出、死区插入这些是给电机控制准备的对LED来说完全是鸡肋配错一点还可能让波形出不来。普通定时器TIM2、TIM3、TIM4、TIM5都可以做PWM。我选TIM3一是因为它在F103上最常见开发板引出的引脚多二是CubeMX里配置非常顺手。TIM3有4个通道可以同时输出4路独立PWM做RGB灯只需要3路做彩色灯板也基本够用。默认情况下TIM3的通道1、通道2、通道3、通道4分别对应PA6、PA7、PB0、PB1。如果这几个引脚被其他外设占用了就需要做引脚重映射。我这次实际项目中把TIM3_CH2用作PWM输出但PA7已经被一个按键占用了所以我把通道2重映射到PC7。TIM3的部分重映射模式下CH2会从PA7挪到PC7CubeMX里只需要把PC7设置为TIM3_CH2功能软件会自动把重映射寄存器配好。2.2 引脚重映射到底做了什么事很多初学者不理解“重映射”这个动作的含义。MCU内部的外设IP和引脚之间的对应关系不是焊死的芯片设计者为了让PCB布线更灵活把同一个外设信号设计成了可以接到多组引脚。比如TIM3_CH2既能出现在PA7也能出现在PC7靠的是AFIO复用功能IO里的重映射寄存器去选择走哪条路。在寄存器层面重映射需要三步打开GPIO时钟、打开AFIO时钟、调用GPIO_PinRemapConfig配置映射关系。传统标准库写起来比较繁琐CubeMX帮我们屏蔽了这些细节。在Pinout视图中勾选TIM3的Channel2后可以直接在弹出的ALT列表里挑选PC7作为输出引脚生成代码时会自动处理AFIO重映射。这里有一个新手容易犯的错误重映射之后原来的默认引脚PA7不会再有TIM3_CH2功能如果你还用示波器去量PA7会什么都量不到误以为代码有问题。我建议在工程文档中明确记录最终的引脚映射关系否则项目隔几周再回来看很容易忘记PC7才是真正的PWM输出脚。2.3 不同平台的PWM能力对比51、树莓派、STM32各有各的玩法并不是所有平台都像STM32一样自带硬件PWM。我整理了一张对比表方便大家根据手头的硬件选路。平台PWM来源适合场景注意事项基础51单片机软件模拟定时器中断翻转IO学习原理、低要求调光分辨率高时中断负载大频率不稳STC8H系列硬件PWM外设低成本小家电调光性价比高寄存器风格偏传统STM32F103硬件PWM普通定时器即可呼吸灯、RGB灯、多路调光配置灵活CubeMX效率高树莓派软件PWM或硬件PWM智能家居原型、Python控制软件PWM抖动大稳定性要求高时用pigpio库NE555硬件电路纯模拟PWM发生器固定频率、固定场景频率和占空比调节相互影响温漂大如果你的项目就是几个按键加一个灯用STC8H会非常合适一颗芯片搞定点亮和调光。如果只是临时验证思路树莓派加Python几行代码就能看到PWM效果但别拿它做量产产品。NE555方案比较古老好处是纯硬件不依赖代码坏处是调节不够精细而且频率会随温度漂移。STM32F103是手头最顺手、性能余量最大的选择也是我这次使用的平台。2.4 CubeMX配置步骤一次配完不返工直接说配置流程按这个步骤操作生成工程后基本不用改太多东西。打开STM32CubeMX新建工程芯片选STM32F103ZET6SYS选择Serial Wire否则芯片下载一次后容易锁死时钟树RCC选择HSE外部晶振把主频配置到72MHz左侧Categories里找到TIM3勾选Channel2 PWM Generation在Pinout视图中把PC7配置为TIM3_CH2在TIM3的Parameter Settings里Prescaler填2Counter Period填1199Pulse填600Polarity选HighProject Manager里生成MDK-ARM工程。Pulse600的意思是初始占空比为50%。后面程序里修改占空比就是改这个值。3. 核心代码从固定占空比到呼吸灯到按键调光3.1 初始化定时器与PWM通道四步固定套路CubeMX生成代码后核心的初始化逻辑已经写好了。理解它的结构非常重要因为修改参数全靠它。初始化的固定套路可以概括为四步使能定时器时钟、配置时基参数PSC和ARR、配置PWM模式通道、启动PWM输出。关键代码如下这是在CubeMX生成的mx_tim3_init基础上做的注释说明static void MX_TIM3_Init(void) { htim3.Instance TIM3; htim3.Init.Prescaler 2; // 预分频值 PSC htim3.Init.CounterMode TIM_COUNTERMODE_UP; // 向上计数 htim3.Init.Period 1199; // 自动重装值 ARR htim3.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; htim3.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_PWM_Init(htim3); sConfigOC.OCMode TIM_OCMODE_PWM1; // PWM模式1 sConfigOC.Pulse 600; // 初始占空比50% sConfigOC.OCPolarity TIM_OCPOLARITY_HIGH; // 高电平有效 sConfigOC.OCFastMode TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(htim3, sConfigOC, TIM_CHANNEL_2); }在主函数中启动PWM输出这步经常被漏掉HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_2);启动之后如果LED不亮而你又确认引脚配置正确很大概率就是忘了这句。之后要调整亮度直接调用宏__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, 300); // 占空比变为 300/1200 25%比较值CCR的范围是0到ARR。当CCR0时PWM输出恒为低灯全灭当CCRARR时输出恒为高灯全亮。记住这套逻辑后面排查问题就非常快。3.2 从0到100再到0呼吸灯的循环控制思路呼吸灯看起来高大上其实就是让CCR在0和ARR之间循环变化占空比从小到大再到小。关键在于变化速度控制要让亮度连续变化而不是跳变。我用的控制逻辑是在while循环里做两个for循环CCR从0递增到1199再从1199递减到0每次变化后延时2毫秒。这样一个来回大约4.8秒节奏比较舒缓看着不眩晕。代码实现如下while (1) { for (uint16_t ccr 0; ccr 1199; ccr) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, ccr); HAL_Delay(2); } for (uint16_t ccr 1199; ccr 0; ccr--) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, ccr); HAL_Delay(2); } }这里有个个人经验呼吸灯“亮起”和“熄灭”的节奏可以不对称。实际感受下来亮起快一点、熄灭慢一点观感更舒服。要做到这个效果只需要两个for循环里的延时时间不同比如递增时延时1ms递减时延时3ms整体就有“缓吸重呼”的感觉。3.3 按键调光占空比边界与防抖呼吸灯是自动过程按键调光则是让用户手动控制亮度。按键调光比呼吸灯稍微复杂的一点在于要处理“占空比边界”和“按键抖动”两个问题。按键消抖建议用延时判断按键按下后延时20ms再读一次确认仍是低电平才认为是有效按下。每次按下按键CCR增加120也就是占空比增加10%超过1199之后回绕到0。这样12档调整逻辑清晰按钮反应用起来也顺手。uint16_t duty 600; while (1) { if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET) { HAL_Delay(20); // 消抖 if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET) { duty 120; if (duty 1199) { duty 0; } __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, duty); while (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET); } } }注意最后那个while等待松开的操作很多教程不会写。如果不等待按键释放按下一次可能会连续触发多次调节从最低亮度直接跳到最高亮度非常影响体验。另外按键消抖延时不建议小于10ms否则在硬件抖动明显的场合效果不佳。4. 实测最容易翻车的三个细节波形、100%占空比和频闪4.1 先看波形再谈亮度Keil仿真里怎么确认PWM输出很多新手在调PWM时LED一亮一灭就急着欢呼实际上PWM到底是不是预期波形完全不知道。LED亮灭只能说明占空比有效不能说明频率对不对。我的习惯是先看波形再谈亮度。没有示波器的情况下可以用Keil的软件仿真先观察逻辑波形。在Keil中进入Debug模式点开View菜单的Analysis Windows选择Logic Analyzer然后添加你要观察的IO端口或者定时器的比较输出寄存器设置合适的显示精度后运行程序就能看到方波。这个方法虽然不如示波器真实但能快速确认PWM逻辑是否符合预期。如果有逻辑分析仪直接接在PWM输出引脚上看是最直观的。逻辑分析仪还能直接测出频率和占空比数值比仿真更可靠。我实测中发现仿真波形正常不代表硬件一定正常因为引脚配置、AFIO重映射、时钟使能这些环节出问题仿真器是看不出来的。4.2 100%占空比输出异常的排查链路网上关于“STM32定时器输出PWM时100%占空比异常”的提问很多我也遇到过。现象是CCR设置为ARR预期全高电平但实际输出变成了全低或者占空比接近100%时波形突然消失。这个问题排查起来并不难按链路一步步走基本能在五分钟内定位。第一步确认PWM通道已经启动。HAL_TIM_PWM_Start没有调用或者调用时通道号写错了根本不会有输出。第二步检查PWM极性。如果配置成了TIM_OCPOLARITY_LOW那么占空比越大反而有效低电平时间越长看起来就是“亮度反向”。第三步检查比较值是否真的写入成功。在线调试时打开Watch窗口查看htim3.Instance-CCR2的值如果和预期不符看看是不是预装载没使能导致CCR写入后没有生效。第四步检查CCR和ARR的类型匹配如果CCR定义成了uint8_t赋值1199会溢出变成175波形自然不对。还有一个特殊情况如果你用的是高级定时器TIM1或TIM8主输出使能位MOE没有置1波形也会消失。TIM3没有这个寄存器所以遇到TIM3全输出异常时优先检查前面四项。我实际遇到最多的原因就是极性配置写反了CubeMX里默认High和Low选反LED的表现会是反逻辑调光亮度调节方向完全相反。4.3 为什么高亮度低频会让人觉得灯在“抖”PWM频率如果太低人眼能直接看到闪烁。但有些人会遇到一种更隐蔽的情况频率测试看起来有几百赫兹理论上人眼感知不到可灯看起来还是在“抖”。这个现象有两个常见来源。第一是频率确实偏低了。人眼对闪光的感知不是“看得到”和“看不到”两种状态中间存在一个临界闪烁频率通常在100Hz左右但LED响应极快、没有白炽灯那样的余辉效应所以200Hz仍然会让部分人觉得不舒服。保险起见PWM频率至少要1kHz以上20kHz是最佳区间。第二是PWM频率和摄像头采样频率之间产生了差拍效应。你用手机拍灯画面里出现明显的滚动条纹就是这个原因。虽然肉眼不一定看得见但手机传感器会把它放大。在实际产品中如果灯具旁边可能被摄像头拍摄建议把PWM频率固定在1kHz以上最好20kHz以上能大幅减少这种频闪感。5. 往深一层玩从Gamma补偿到RGB混色、再到电机控制5.1 线性占空比不等于线性亮度人眼对亮度是非线性感知的做PWM调光一段时间后你会发现一个反直觉的现象把占空比从0加到50%时亮度变化非常明显但从50%加到100%时肉眼觉得后面半段亮度几乎没有变。这不是占空比不对而是人眼感知的特性决定的。人眼对暗部细节更敏感对亮部的分辨率则较低整体近似一条幂函数曲线。要让调光过程在视觉上均匀需要做Gamma补偿。具体做法是把理想的线性亮度值经过一次幂运算再映射到CCR。公式是D_output 1199 × (level / 100)^2.2假设当前占空比是50%线性直接写599但经过Gamma补偿后只写1199 × 0.5^2.2 ≈ 272。在这个占空比下人眼感知到的亮度才是“全程均匀的一半”。更讲究的做法是做成查表把Gamma曲线预先算好放在常量数组里运行时直接按索引取值避免MCU现场做浮点pow运算既慢又占flash。另外LED本身的光通量和电流也不是严格线性尤其大功率LED在低电流区间光电效率更高在50%电流以下发光效率会和理想值偏离更多。两者叠加之后线性PWM占空比带来的实际视觉变化更不线性。这也是为什么高端调光灯具都会内置Gamma表而不是单纯“占空比加大10%”。5.2 用三路PWM做RGB混色颜色和亮度要分开调RGB彩色LED灯本质上是把红、绿、蓝三颗LED封装在一起或者做在同一个模组上。三路PWM分别控制三个通道的占空比就能混出各种颜色。颜色取决于三路占空比的相对比例亮度取决于三路占空比的绝对值这两个维度如果纠缠在一起调色就会很痛苦。我推荐的做法是先确定目标亮度和目标颜色把颜色值从0到255的三个分量按比例映射到各自通道的CCR。比如纯红色是(255, 0, 0)映射后G通道和B通道的CCR是0如果希望整体亮度减半则三个通道的CCR同时乘以0.5。这样调色和调光就分开了。RGB还有一个实际坑红绿蓝三色LED的额定电压和前向电流不一样相同占空比下混出来的白色往往是偏色的。所以RGB混色基本不可能一上来就精确必须实测校准。我的做法是先让三路都输出50%再用相机或者肉眼参考调整某个通道的CCR直到颜色接近纯白然后把校准后的比例固化到代码里。5.3 驱动大功率LED与PWM扩展GPIO直驱的边界在哪GPIO引脚输出的驱动能力有限STM32的IO口拉电流和灌电流能力大概在20毫安左右直接驱动一颗3mm或者5mm的小LED加限流电阻完全没问题。但如果是1W、3W的大功率LED需要几百毫安甚至安培级别的电流这时候绝对不能直接把LED接到GPIO上。我建议用NPN三极管或N-MOS管做低端开关PWM信号加在栅极或基极上LED和限流电阻串联在电源和开关管之间。以N-MOS管为例源极接地漏极接LED负极LED正极通过限流电阻接电源正极。GPIO输出的PWM接栅极MOS管按PWM的频率和占空比导通或者关断。选择MOS管时要注意栅极阈值电压有些MOS管5V才能完全导通3.3V的控制信号推不动要选逻辑电平MOS管。如果把PWM驱动对象从LED换成电机就要格外小心。因为电机是感性负载切断电流瞬间会感应出很高的反向电动势如果不加续流二极管很容易击穿MOS管或三极管。LED本身是二极管对反向电压的耐受能力有限接反或者杂散电感产生的反压同样可能损坏它。而我前面提到的TIM1高级定时器之所以在电机控制中地位特殊就是因为它支持互补输出、死区插入和刹车保护这些功能在LED调光场景中用不上但在电机驱动中缺一不可。如果后续打算把PWM玩法扩展到电机上建议从带死区的互补PWM和续流电路开始研究这和LED调光完全是两个路子。文章写到这里其实已经把我从“串电阻调光”到“TIM3输出PWM调光”整个过程中的核心认知都整理完了。最后再分享一个我的习惯每次改完占空比参数我会先用逻辑分析仪抓一段波形确认实际输出的频率和占空比与理论计算一致再去看LED效果。这个习惯帮我省掉了大量“亮度不对、颜色不对、闪烁”的排查时间。PWM调光入门不难难的是把频率、分辨率、引脚映射、电路驱动这些环节都串起来综合考虑希望这篇文章能让你少走一些弯路。本文还有配套的精品资源点击获取
简介这套压缩包以STC12C2052单片机为核心完整演示了利用PWM脉宽调制技术调节LED灯亮度的过程面向单片机初学者和电子爱好者用于学习无级调光、占空比概念及PWM模块配置。包内共55个文件以C源码、Keil工程.uv2、编译生成的hex固件及各类备份文件为主rar压缩后仅44KB小巧方便可直接导入Keil查看或烧录验证。目前已有813人学习其中既有基础PWM调光例程也有键盘、显示、自动控制等多个功能模块的工程代码便于对比不同实现方式。通过修改占空比参数可以直观看到LED亮度从暗到亮的连续变化同时理解STC12C2052内置PWM模块无需额外硬件即可输出可调方波的硬件特性。这套资料可作为室内照明调光、指示灯亮度控制等新手项目的起步参考既能训练C语言编程也能掌握单片机定时器与PWM协同工作的调试方法。 我最早接触LED调光的时候脑子里想到的第一个方案就是串电阻。后来做项目甲方要求亮度连续可调还得低发热、不闪、寿命不缩水才发现“高频开关”比“线性限流”聪明得多。PWM脉冲宽度调制本质上不是在调电流而是在调导通时间占比——LED在高频亮灭之间切换人眼感受到的是平均亮度。这篇文章我就以STM32F103ZET6的TIM3为例把PWM调光的原理、引脚配置、代码实现和实测中容易踩的坑完整讲一遍。适合手里有开发板、想从“点灯”进阶到“调光”的读者也适合准备用PWM驱动LED或电机、但对占空比和频率还没完全理清思路的朋友。1. 为什么PWM是LED调光的“最优解”原理里藏着答案1.1 线性降压调光的三个短板很多新手会问LED亮度不是可以用电阻限流吗我做个小夜灯串电阻能调光为什么非要上PWM我实际对比过线性方案有三个绕不开的问题。第一个是效率。电阻降压的原理是消耗多余能量电流越大发热越狠。用电池供电的小设备电阻上白白烧掉的热量直接决定了续航时间。第二个问题是色温漂移。LED的色温会随电流变化你用电流方式调光低亮度下灯会明显发黄、发暗而PWM调光让LED始终工作在其额定的电流区间色温和光谱基本不漂。第三个问题是失控区。很多LED在低于某阈值电流后直接不亮或者严重非线性导致暗部调光根本没法用。而PWM调光相当于在“全亮”和“熄灭”之间切理论上可以实现从0%到100%的完整调节范围。所以工程上真正被大量使用的方案是让LED工作在额定的峰值电流下再用PWM控制导通时间占比也就是占空比。LED的响应速度是微秒级别的远快于开关切换速度所以每一次导通、截止都干净利落没有拖泥带水的过渡区。1.2 占空比、频率、分辨率三个参数怎么互相牵制PWM有三个核心参数频率、占空比、分辨率。很多人只知道占空比越大灯越亮但另外两个参数才是真正决定调光效果的关键。占空比就是高电平时间占整个周期的比例。50%占空比下LED的理论平均亮度就是额定亮度的50%。频率决定了开关快慢一般至少要高于1kHz否则不仅肉眼能感受到闪烁长时间在这种光下工作眼睛也容易疲劳。分辨率则取决于PWM周期被分成了多少份也就是ARR值。ARR999时占空比可以做到0.1%步进也就是约10位分辨率ARR4999时步进是0.02%约12位。人眼对亮度分辨能力有限实际灯具做到10~12位已经非常平滑盲目堆分辨率只会让程序计算变重没有太多感知上的收益。这三个参数不是独立的它们被定时器主频锁在一起。在STM32F103上TIM3的时钟默认是72MHz计算公式是PWM频率 72MHz / ((PSC 1) × (ARR 1))我希望PWM频率为20kHz并获得约1200级的分辨率那么PSC和ARR的乘积应为3600。我常用的组合是PSC2、ARR1199算出来正好是72MHz / (3 × 1200) 20kHz。实际计算时不必追求完美整数只要对亮度没有特殊要求差几百赫兹完全无感。但要注意这个计算是基于“APB1定时器时钟已经倍频到72MHz”的前提STM32CubeMX默认配置下APB1外设时钟是36MHz但定时器时钟会自动倍频到72MHz不少人在手动配置时会在这里少乘一个2导致PWM实际频率只有预期的一半。这是一个非常隐蔽的坑后面实测排查部分我还会提到。2. 从引脚规划到CubeMX配置让TIM3先输出一路PWM2.1 为什么我只选TIM3而不是TIM1/高级定时器网上很多教程上来就用TIM1做PWM理由是“高级定时器功能更强”。但LED调光这件事普通定时器和高级定时器做出来的效果没有任何区别反而TIM1/TIM8还有很多额外寄存器需要处理比如刹车输入、互补输出、死区插入这些是给电机控制准备的对LED来说完全是鸡肋配错一点还可能让波形出不来。普通定时器TIM2、TIM3、TIM4、TIM5都可以做PWM。我选TIM3一是因为它在F103上最常见开发板引出的引脚多二是CubeMX里配置非常顺手。TIM3有4个通道可以同时输出4路独立PWM做RGB灯只需要3路做彩色灯板也基本够用。默认情况下TIM3的通道1、通道2、通道3、通道4分别对应PA6、PA7、PB0、PB1。如果这几个引脚被其他外设占用了就需要做引脚重映射。我这次实际项目中把TIM3_CH2用作PWM输出但PA7已经被一个按键占用了所以我把通道2重映射到PC7。TIM3的部分重映射模式下CH2会从PA7挪到PC7CubeMX里只需要把PC7设置为TIM3_CH2功能软件会自动把重映射寄存器配好。2.2 引脚重映射到底做了什么事很多初学者不理解“重映射”这个动作的含义。MCU内部的外设IP和引脚之间的对应关系不是焊死的芯片设计者为了让PCB布线更灵活把同一个外设信号设计成了可以接到多组引脚。比如TIM3_CH2既能出现在PA7也能出现在PC7靠的是AFIO复用功能IO里的重映射寄存器去选择走哪条路。在寄存器层面重映射需要三步打开GPIO时钟、打开AFIO时钟、调用GPIO_PinRemapConfig配置映射关系。传统标准库写起来比较繁琐CubeMX帮我们屏蔽了这些细节。在Pinout视图中勾选TIM3的Channel2后可以直接在弹出的ALT列表里挑选PC7作为输出引脚生成代码时会自动处理AFIO重映射。这里有一个新手容易犯的错误重映射之后原来的默认引脚PA7不会再有TIM3_CH2功能如果你还用示波器去量PA7会什么都量不到误以为代码有问题。我建议在工程文档中明确记录最终的引脚映射关系否则项目隔几周再回来看很容易忘记PC7才是真正的PWM输出脚。2.3 不同平台的PWM能力对比51、树莓派、STM32各有各的玩法并不是所有平台都像STM32一样自带硬件PWM。我整理了一张对比表方便大家根据手头的硬件选路。平台PWM来源适合场景注意事项基础51单片机软件模拟定时器中断翻转IO学习原理、低要求调光分辨率高时中断负载大频率不稳STC8H系列硬件PWM外设低成本小家电调光性价比高寄存器风格偏传统STM32F103硬件PWM普通定时器即可呼吸灯、RGB灯、多路调光配置灵活CubeMX效率高树莓派软件PWM或硬件PWM智能家居原型、Python控制软件PWM抖动大稳定性要求高时用pigpio库NE555硬件电路纯模拟PWM发生器固定频率、固定场景频率和占空比调节相互影响温漂大如果你的项目就是几个按键加一个灯用STC8H会非常合适一颗芯片搞定点亮和调光。如果只是临时验证思路树莓派加Python几行代码就能看到PWM效果但别拿它做量产产品。NE555方案比较古老好处是纯硬件不依赖代码坏处是调节不够精细而且频率会随温度漂移。STM32F103是手头最顺手、性能余量最大的选择也是我这次使用的平台。2.4 CubeMX配置步骤一次配完不返工直接说配置流程按这个步骤操作生成工程后基本不用改太多东西。打开STM32CubeMX新建工程芯片选STM32F103ZET6SYS选择Serial Wire否则芯片下载一次后容易锁死时钟树RCC选择HSE外部晶振把主频配置到72MHz左侧Categories里找到TIM3勾选Channel2 PWM Generation在Pinout视图中把PC7配置为TIM3_CH2在TIM3的Parameter Settings里Prescaler填2Counter Period填1199Pulse填600Polarity选HighProject Manager里生成MDK-ARM工程。Pulse600的意思是初始占空比为50%。后面程序里修改占空比就是改这个值。3. 核心代码从固定占空比到呼吸灯到按键调光3.1 初始化定时器与PWM通道四步固定套路CubeMX生成代码后核心的初始化逻辑已经写好了。理解它的结构非常重要因为修改参数全靠它。初始化的固定套路可以概括为四步使能定时器时钟、配置时基参数PSC和ARR、配置PWM模式通道、启动PWM输出。关键代码如下这是在CubeMX生成的mx_tim3_init基础上做的注释说明static void MX_TIM3_Init(void) { htim3.Instance TIM3; htim3.Init.Prescaler 2; // 预分频值 PSC htim3.Init.CounterMode TIM_COUNTERMODE_UP; // 向上计数 htim3.Init.Period 1199; // 自动重装值 ARR htim3.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; htim3.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_PWM_Init(htim3); sConfigOC.OCMode TIM_OCMODE_PWM1; // PWM模式1 sConfigOC.Pulse 600; // 初始占空比50% sConfigOC.OCPolarity TIM_OCPOLARITY_HIGH; // 高电平有效 sConfigOC.OCFastMode TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(htim3, sConfigOC, TIM_CHANNEL_2); }在主函数中启动PWM输出这步经常被漏掉HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_2);启动之后如果LED不亮而你又确认引脚配置正确很大概率就是忘了这句。之后要调整亮度直接调用宏__HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, 300); // 占空比变为 300/1200 25%比较值CCR的范围是0到ARR。当CCR0时PWM输出恒为低灯全灭当CCRARR时输出恒为高灯全亮。记住这套逻辑后面排查问题就非常快。3.2 从0到100再到0呼吸灯的循环控制思路呼吸灯看起来高大上其实就是让CCR在0和ARR之间循环变化占空比从小到大再到小。关键在于变化速度控制要让亮度连续变化而不是跳变。我用的控制逻辑是在while循环里做两个for循环CCR从0递增到1199再从1199递减到0每次变化后延时2毫秒。这样一个来回大约4.8秒节奏比较舒缓看着不眩晕。代码实现如下while (1) { for (uint16_t ccr 0; ccr 1199; ccr) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, ccr); HAL_Delay(2); } for (uint16_t ccr 1199; ccr 0; ccr--) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, ccr); HAL_Delay(2); } }这里有个个人经验呼吸灯“亮起”和“熄灭”的节奏可以不对称。实际感受下来亮起快一点、熄灭慢一点观感更舒服。要做到这个效果只需要两个for循环里的延时时间不同比如递增时延时1ms递减时延时3ms整体就有“缓吸重呼”的感觉。3.3 按键调光占空比边界与防抖呼吸灯是自动过程按键调光则是让用户手动控制亮度。按键调光比呼吸灯稍微复杂的一点在于要处理“占空比边界”和“按键抖动”两个问题。按键消抖建议用延时判断按键按下后延时20ms再读一次确认仍是低电平才认为是有效按下。每次按下按键CCR增加120也就是占空比增加10%超过1199之后回绕到0。这样12档调整逻辑清晰按钮反应用起来也顺手。uint16_t duty 600; while (1) { if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET) { HAL_Delay(20); // 消抖 if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET) { duty 120; if (duty 1199) { duty 0; } __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_2, duty); while (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) GPIO_PIN_RESET); } } }注意最后那个while等待松开的操作很多教程不会写。如果不等待按键释放按下一次可能会连续触发多次调节从最低亮度直接跳到最高亮度非常影响体验。另外按键消抖延时不建议小于10ms否则在硬件抖动明显的场合效果不佳。4. 实测最容易翻车的三个细节波形、100%占空比和频闪4.1 先看波形再谈亮度Keil仿真里怎么确认PWM输出很多新手在调PWM时LED一亮一灭就急着欢呼实际上PWM到底是不是预期波形完全不知道。LED亮灭只能说明占空比有效不能说明频率对不对。我的习惯是先看波形再谈亮度。没有示波器的情况下可以用Keil的软件仿真先观察逻辑波形。在Keil中进入Debug模式点开View菜单的Analysis Windows选择Logic Analyzer然后添加你要观察的IO端口或者定时器的比较输出寄存器设置合适的显示精度后运行程序就能看到方波。这个方法虽然不如示波器真实但能快速确认PWM逻辑是否符合预期。如果有逻辑分析仪直接接在PWM输出引脚上看是最直观的。逻辑分析仪还能直接测出频率和占空比数值比仿真更可靠。我实测中发现仿真波形正常不代表硬件一定正常因为引脚配置、AFIO重映射、时钟使能这些环节出问题仿真器是看不出来的。4.2 100%占空比输出异常的排查链路网上关于“STM32定时器输出PWM时100%占空比异常”的提问很多我也遇到过。现象是CCR设置为ARR预期全高电平但实际输出变成了全低或者占空比接近100%时波形突然消失。这个问题排查起来并不难按链路一步步走基本能在五分钟内定位。第一步确认PWM通道已经启动。HAL_TIM_PWM_Start没有调用或者调用时通道号写错了根本不会有输出。第二步检查PWM极性。如果配置成了TIM_OCPOLARITY_LOW那么占空比越大反而有效低电平时间越长看起来就是“亮度反向”。第三步检查比较值是否真的写入成功。在线调试时打开Watch窗口查看htim3.Instance-CCR2的值如果和预期不符看看是不是预装载没使能导致CCR写入后没有生效。第四步检查CCR和ARR的类型匹配如果CCR定义成了uint8_t赋值1199会溢出变成175波形自然不对。还有一个特殊情况如果你用的是高级定时器TIM1或TIM8主输出使能位MOE没有置1波形也会消失。TIM3没有这个寄存器所以遇到TIM3全输出异常时优先检查前面四项。我实际遇到最多的原因就是极性配置写反了CubeMX里默认High和Low选反LED的表现会是反逻辑调光亮度调节方向完全相反。4.3 为什么高亮度低频会让人觉得灯在“抖”PWM频率如果太低人眼能直接看到闪烁。但有些人会遇到一种更隐蔽的情况频率测试看起来有几百赫兹理论上人眼感知不到可灯看起来还是在“抖”。这个现象有两个常见来源。第一是频率确实偏低了。人眼对闪光的感知不是“看得到”和“看不到”两种状态中间存在一个临界闪烁频率通常在100Hz左右但LED响应极快、没有白炽灯那样的余辉效应所以200Hz仍然会让部分人觉得不舒服。保险起见PWM频率至少要1kHz以上20kHz是最佳区间。第二是PWM频率和摄像头采样频率之间产生了差拍效应。你用手机拍灯画面里出现明显的滚动条纹就是这个原因。虽然肉眼不一定看得见但手机传感器会把它放大。在实际产品中如果灯具旁边可能被摄像头拍摄建议把PWM频率固定在1kHz以上最好20kHz以上能大幅减少这种频闪感。5. 往深一层玩从Gamma补偿到RGB混色、再到电机控制5.1 线性占空比不等于线性亮度人眼对亮度是非线性感知的做PWM调光一段时间后你会发现一个反直觉的现象把占空比从0加到50%时亮度变化非常明显但从50%加到100%时肉眼觉得后面半段亮度几乎没有变。这不是占空比不对而是人眼感知的特性决定的。人眼对暗部细节更敏感对亮部的分辨率则较低整体近似一条幂函数曲线。要让调光过程在视觉上均匀需要做Gamma补偿。具体做法是把理想的线性亮度值经过一次幂运算再映射到CCR。公式是D_output 1199 × (level / 100)^2.2假设当前占空比是50%线性直接写599但经过Gamma补偿后只写1199 × 0.5^2.2 ≈ 272。在这个占空比下人眼感知到的亮度才是“全程均匀的一半”。更讲究的做法是做成查表把Gamma曲线预先算好放在常量数组里运行时直接按索引取值避免MCU现场做浮点pow运算既慢又占flash。另外LED本身的光通量和电流也不是严格线性尤其大功率LED在低电流区间光电效率更高在50%电流以下发光效率会和理想值偏离更多。两者叠加之后线性PWM占空比带来的实际视觉变化更不线性。这也是为什么高端调光灯具都会内置Gamma表而不是单纯“占空比加大10%”。5.2 用三路PWM做RGB混色颜色和亮度要分开调RGB彩色LED灯本质上是把红、绿、蓝三颗LED封装在一起或者做在同一个模组上。三路PWM分别控制三个通道的占空比就能混出各种颜色。颜色取决于三路占空比的相对比例亮度取决于三路占空比的绝对值这两个维度如果纠缠在一起调色就会很痛苦。我推荐的做法是先确定目标亮度和目标颜色把颜色值从0到255的三个分量按比例映射到各自通道的CCR。比如纯红色是(255, 0, 0)映射后G通道和B通道的CCR是0如果希望整体亮度减半则三个通道的CCR同时乘以0.5。这样调色和调光就分开了。RGB还有一个实际坑红绿蓝三色LED的额定电压和前向电流不一样相同占空比下混出来的白色往往是偏色的。所以RGB混色基本不可能一上来就精确必须实测校准。我的做法是先让三路都输出50%再用相机或者肉眼参考调整某个通道的CCR直到颜色接近纯白然后把校准后的比例固化到代码里。5.3 驱动大功率LED与PWM扩展GPIO直驱的边界在哪GPIO引脚输出的驱动能力有限STM32的IO口拉电流和灌电流能力大概在20毫安左右直接驱动一颗3mm或者5mm的小LED加限流电阻完全没问题。但如果是1W、3W的大功率LED需要几百毫安甚至安培级别的电流这时候绝对不能直接把LED接到GPIO上。我建议用NPN三极管或N-MOS管做低端开关PWM信号加在栅极或基极上LED和限流电阻串联在电源和开关管之间。以N-MOS管为例源极接地漏极接LED负极LED正极通过限流电阻接电源正极。GPIO输出的PWM接栅极MOS管按PWM的频率和占空比导通或者关断。选择MOS管时要注意栅极阈值电压有些MOS管5V才能完全导通3.3V的控制信号推不动要选逻辑电平MOS管。如果把PWM驱动对象从LED换成电机就要格外小心。因为电机是感性负载切断电流瞬间会感应出很高的反向电动势如果不加续流二极管很容易击穿MOS管或三极管。LED本身是二极管对反向电压的耐受能力有限接反或者杂散电感产生的反压同样可能损坏它。而我前面提到的TIM1高级定时器之所以在电机控制中地位特殊就是因为它支持互补输出、死区插入和刹车保护这些功能在LED调光场景中用不上但在电机驱动中缺一不可。如果后续打算把PWM玩法扩展到电机上建议从带死区的互补PWM和续流电路开始研究这和LED调光完全是两个路子。文章写到这里其实已经把我从“串电阻调光”到“TIM3输出PWM调光”整个过程中的核心认知都整理完了。最后再分享一个我的习惯每次改完占空比参数我会先用逻辑分析仪抓一段波形确认实际输出的频率和占空比与理论计算一致再去看LED效果。这个习惯帮我省掉了大量“亮度不对、颜色不对、闪烁”的排查时间。PWM调光入门不难难的是把频率、分辨率、引脚映射、电路驱动这些环节都串起来综合考虑希望这篇文章能让你少走一些弯路。本文还有配套的精品资源点击获取
