STM32标准库实战——按键调节PWM占空比实现动态亮度控制-育师

1. 从零开始：为什么你需要掌握动态PWM调光？

大家好，我是老张，在嵌入式这行摸爬滚打十几年了，从51单片机一路玩到现在的各种ARM核。今天想和大家聊聊一个在STM32项目里出场率极高，但又让很多新手朋友感到头疼的功能：用按键动态调节PWM占空比来控制LED亮度。你可能觉得，不就是让灯变亮点变暗点嘛，有什么难的？但说实话，我第一次做的时候也踩了不少坑，比如按键按下去没反应、亮度变化不线性、甚至程序跑飞了。这些问题的根源，往往在于对PWM和中断配合工作的机制理解不够透彻。

这个实验的实用性超乎你的想象。它绝不仅仅是让一个LED灯呼吸那么简单。PWM（脉冲宽度调制）是现代数字控制模拟量的核心技术。你想想，家里的智能台灯是不是可以无级调光？你的电脑风扇是不是能根据温度自动调节转速？甚至一些高级的无人机，其电机的精准调速都离不开PWM。它们的底层逻辑，和我们今天要做的这个STM32实验是一脉相承的。通过两个小小的按键，就能实时、平滑地控制一个输出通道的“能量”大小，这种能力是打开电机控制、智能调光、电源管理等一系列高级应用大门的钥匙。

我比较推崇使用标准库来入门STM32，特别是对于刚从51或Arduino转过来的朋友。标准库的代码虽然看起来比HAL库冗长一些，但它把底层寄存器操作封装成了一个个看得见、摸得着的函数。你在调用TIM_SetCompare2的时候，能清晰地知道它就是在修改TIM3->CCR2这个寄存器的值。这种“知其然也知其所以然”的感觉，对打牢嵌入式基础至关重要。等咱们把标准库玩转了，再去接触HAL库或者LL库，就会有一种居高临下、一览众山小的通透感。好了，闲话不多说，咱们直接撸起袖子，看看怎么用STM32F103这块经典芯片，通过标准库把这件事漂亮地干成。

2. 硬件与原理：PWM是如何“欺骗”世界的？

在写代码之前，咱们必须把几个关键概念掰扯清楚。这就像盖房子要先打地基，地基不稳，代码写得再花哨也是空中楼阁。

2.1 PWM的本质：一场精妙的“数字谎言”

PWM，中文叫脉冲宽度调制。这个名字听起来很高大上，但其实它的思想非常直观。单片机是数字世界的产物，它只能输出高电平（比如3.3V）或低电平（0V）。但我们生活的世界是模拟的，比如我们想让LED亮度是1.65V电压时的效果，纯数字的单片机直接做不到。那怎么办呢？PWM想出了一个绝妙的办法：用一系列快速开关的脉冲来“模拟”出一个中间电压。

我来打个比方。假设你面前有一个水龙头，你在一分钟内快速地将它打开30秒，再关闭30秒，那么平均下来，这一分钟内的水流速度就相当于水龙头半开时的速度。PWM也是同样的道理：在一个固定的周期内，如果高电平（打开）的时间占一半，那么用这个信号去驱动一个LED，由于人眼的视觉暂留效应和LED本身的响应特性，我们看到的亮度就相当于用一半电压驱动时的亮度。这个“高电平时间占整个周期的比例”，就是我们反复提到的占空比。占空比0%就是常灭，100%就是常亮，50%就是半亮。你看，单片机通过控制“开关”的时间比例，成功地说了一个“谎”，让模拟设备以为它收到了一个中间的电压值。

2.2 硬件连接图：把线接对是成功的一半

这个实验的硬件电路非常简单，但接错了灯可不亮。我们以最常见的STM32F103C8T6核心板为例：

LED电路：将LED的正极（长脚）通过一个1kΩ的限流电阻，连接到芯片的PB5引脚。LED的负极（短脚）接地（GND）。这个电阻必不可少，它能保护你的LED和单片机的IO口不被过大的电流烧坏。
按键电路：我们需要两个按键。KEY1（递增按键）的一端接PA0，另一端接地。KEY3（递减按键）的一端接PC13（很多核心板的用户按键就是这个引脚），另一端接地。同时，需要在PA0和PC13这两个引脚上，各连接一个上拉电阻（比如10kΩ）到3.3V。这样，当按键没有按下时，单片机读到的是高电平；按键按下时，引脚被拉到地，读到低电平。这种配置方式称为“上拉输入”，是读取按键状态的经典接法。

这里有个关键点：为什么是PB5？因为在我们使用的STM32F103系列中，定时器TIM3的通道2（CH2），其输出引脚可以通过重映射功能，连接到PB5。这就是我们选择这个引脚的原因。如果你用的开发板LED正好接在PB5，那太巧了；如果不是，你可能需要根据原理图调整引脚，或者使用其他支持PWM输出的引脚和定时器通道。

2.3 定时器如何产生PWM：核心寄存器揭秘

STM32的PWM功能是由其高级或通用定时器产生的。你可以把定时器想象成一个自动的、精准的“秒表”。我们以本实验用的TIM3为例，它有几个关键寄存器在扮演核心角色：

TIMx_ARR（自动重装载寄存器）：这个寄存器决定了PWM的频率。定时器的计数器TIMx_CNT会从0开始向上计数，每来一个时钟脉冲就加1，一直加到ARR的值，然后瞬间归零，重新开始，这就形成了一个周期。ARR的值越大，计数到顶的时间越长，周期就越长，频率就越低。
TIMx_PSC（预分频器）：这个寄存器用来对系统时钟进行“降速”。如果系统时钟是72MHz，PSC设置为719，那么实际驱动定时器计数的时钟就变成了72MHz / (719+1) = 100kHz。它和ARR共同决定了最终的PWM频率。
TIMx_CCRx（捕获/比较寄存器，这里x是通道号2）：这是控制占空比的灵魂寄存器！我们程序中调用的TIM_SetCompare2函数，就是修改这个TIM3->CCR2的值。定时器会一直拿当前计数值CNT和CCR2的值做比较。
TIMx_CNT（计数器）：这个寄存器不停地循环累加，是PWM波形产生的“发动机”。

它们是如何协作的呢？假设我们设置ARR=599，CCR2=300。在PWM模式2、向上计数、输出极性为低的情况下，规则是这样的：

当CNT从0开始计数，只要CNT < CCR2（即0到299），输出引脚就保持为无效电平（我们设置为高电平）。
当CNT增长到等于或大于CCR2（即300到599），输出引脚就翻转为有效电平（低电平）。
CNT到达599后，下一个时钟到来时归零，同时硬件自动将CCR2预装载寄存器的值更新到当前比较寄存器，开始下一个周期。

如此周而复始，我们就得到了一个周期为600个计数时钟、高电平占300个时钟的方波，占空比正好是50%。通过修改CCR2的值，我们就能轻松改变高电平的时间宽度，从而改变占空比。这就是全部的秘密。

3. 软件设计：构建清晰、健壮的代码框架

理解了原理，我们就可以动手搭建代码了。好的代码结构就像整洁的房间，东西在哪一目了然，后期维护和功能扩展会非常轻松。我不喜欢把所有的代码都堆在main.c里，那会变成“意大利面条式”的代码，今天咱们来把它模块化。

3.1 工程结构与模块划分

我建议为这个项目建立至少三个独立的.c/.h文件对：

bsp_pwm.c/h：板级支持包——PWM模块。所有关于定时器初始化、PWM输出配置、占空比设置的函数都放在这里。它只关心如何产生PWM波，不关心谁在控制它。
bsp_key.c/h：板级支持包——按键模块。负责按键GPIO的初始化、按键扫描（或中断检测）、消抖处理，并提供一个清晰的按键事件接口（如“KEY1按下”“KEY3按下”）。
main.c：主程序。它像一个大管家，初始化各个模块，然后在一个大循环里，询问按键模块：“有按键事件吗？”如果有，就调用PWM模块的增减函数来改变占空比。

这种模块化的好处是，如果明天你想把按键从PA0换成PE2，只需要修改bsp_key.c里的初始化代码，其他文件一行都不用动。如果想把PWM从TIM3_CH2改成TIM4_CH1，也只需改动bsp_pwm.c。代码的可移植性和可读性大大增强。

3.2 按键处理：消抖与状态机

按键处理是嵌入式开发中最基础也最容易出bug的地方。机械按键在按下和弹起的瞬间，会产生一连串快速的抖动（可能持续5-20ms），如果程序直接读取引脚电平，可能会误判为多次按下。

我常用的有两种可靠方法：

定时器中断扫描法：配置一个基本定时器（如TIM2），每5ms中断一次。在中断服务函数里，读取按键引脚电平。如果连续3次（即15ms）都读到低电平，就认为按键稳定按下，置位一个“按键按下”标志。主循环中检测到这个标志，再执行相应的占空比调节操作，最后清除标志。这种方法消耗CPU资源极少，非常可靠。
外部中断+软件定时器法：将按键引脚配置为外部中断下降沿触发。一旦按键按下（下降沿），立即进入中断，然后关闭这个外部中断（防止抖动期间反复进入），同时启动一个软件定时器（或硬件定时器）。15ms后，在定时器中断里再次读取按键引脚，如果仍是低电平，则确认按键按下，执行操作；最后，再重新使能外部中断。这种方法响应速度极快。

在bsp_key.c里，我会提供一个函数，比如Key_GetEvent()，它返回一个枚举值，像KEY_EVENT_NONE、KEY_EVENT_1_DOWN、KEY_EVENT_3_DOWN。这样主函数里的逻辑就非常清晰：if(Key_GetEvent() == KEY_EVENT_1_DOWN) { IncPWMDutyCycle(); }。

3.3 PWM模块核心函数实现

现在，让我们深入bsp_pwm.c，看看几个核心函数具体是怎么写的。这里我会用标准库函数来操作，你可以清晰地看到每一步在做什么。

首先是最重要的初始化函数PWM_Init：

void PWM_Init(u16 arr, u16 psc) { GPIO_InitTypeDef GPIO_InitStructure; TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; // 1. 开启时钟——任何外设操作前都必须做的第一步！ RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); // TIM3挂载在APB1总线 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB | RCC_APB2Periph_AFIO, ENABLE); // GPIOB和AFIO在APB2 // 2. 配置PB5为复用推挽输出 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出，这是PWM输出引脚的标准模式 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 速度设高一些，波形边沿更陡峭 GPIO_Init(GPIOB, &GPIO_InitStructure); // 3. 关键一步：部分重映射，将TIM3_CH2映射到PB5 GPIO_PinRemapConfig(GPIO_PartialRemap_TIM3, ENABLE); // 4. 初始化TIM3时基单元，决定PWM频率 TIM_TimeBaseStructure.TIM_Period = arr; // 自动重装载值，决定周期 TIM_TimeBaseStructure.TIM_Prescaler = psc; // 预分频系数，对主频分频 TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; // 时钟分频，通常不分 TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; // 向上计数模式 TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure); // 5. 初始化TIM3通道2为PWM模式2 TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM2; // 选择PWM模式2 TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; // 使能输出 TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_Low; // 输出极性：低电平有效 // 注意：这里使用TIM_OC2Init，2代表通道2 TIM_OC2Init(TIM3, &TIM_OCInitStructure); // 6. 使能通道2的预装载寄存器（重要！） TIM_OC2PreloadConfig(TIM3, TIM_OCPreload_Enable); // 7. 使能TIM3的ARR预装载寄存器（保证频率和占空比同步更新，无毛刺） TIM_ARRPreloadConfig(TIM3, ENABLE); // 8. 启动定时器！ TIM_Cmd(TIM3, ENABLE); }

初始化完成后，PWM波形就已经开始输出了，只不过此时占空比是0（因为CCR2默认是0）。我们需要两个函数来改变它：

// 设置绝对占空比，val范围应在0到ARR值之间 void PWM_SetDutyCycle(u16 duty) { if(duty > PWM_PERIOD) duty = PWM_PERIOD; // PWM_PERIOD是定义的ARR值，比如599 TIM_SetCompare2(TIM3, duty); } // 根据按键递增占空比，步进为ARR的1/12 void PWM_IncreaseDuty(void) { static u16 current_duty = 0; u16 step = PWM_PERIOD / 12; // 计算步进值，例如599/12≈50 if(current_duty + step <= PWM_PERIOD) { current_duty += step; } else { current_duty = PWM_PERIOD; // 达到最大值 } PWM_SetDutyCycle(current_duty); } // 递减函数PWM_DecreaseDuty逻辑类似，这里省略

你看，PWM_SetCompare2这个库函数，就是我们控制占空比的“遥控器”。而PWM_IncreaseDuty函数里我使用了一个static变量来保存当前占空比，这样它的值在函数调用结束后不会丢失，非常适用于这种需要记录状态的情景。

4. 调试与优化：让效果更上一层楼

代码写完、编译通过，只是万里长征第一步。把板子通上电，LED可能亮了，但按键按下去，亮度变化可能不如你想象中那么完美。别急，调试阶段才是真正长本事的时侯。

4.1 使用示波器观察波形

如果你手边有示波器，那绝对是调试利器。把探头接到PB5引脚和地之间，你应该能看到一个标准的方波。

测频率：调整示波器的时基，让屏幕上显示2-3个完整的波形周期，测量周期时间T，频率f=1/T。算一下是不是我们预设的120Hz（周期约8.33ms）。如果不是，检查TIM_Period和TIM_Prescaler的计算是否正确。公式是：PWM频率 = 系统时钟 / ((PSC+1) * (ARR+1))。以72MHz系统时钟，PSC=999，ARR=599为例：72,000,000 / (1000 * 600) = 120Hz，完美。
测占空比：示波器一般都有自动测量占空比的功能。按下KEY1，你应该能看到高电平的宽度（正脉宽）在阶梯式地增加，占空比从0%一步步跳到100%。观察波形是否干净，边沿是否陡峭。如果边沿很缓，可能是GPIO速度设置过低，或者负载（LED和电阻）过重。

4.2 解决亮度变化不线性问题

你可能会发现，LED亮度从0%增加到10%，感觉变化很明显；但从80%增加到90%，感觉变化不大。这是正常的，因为人眼对光强的感知是非线性的，近似于对数关系。而我们PWM的占空比是线性变化的。对于要求高的调光应用（如阅读灯），我们需要进行伽马校正。

简单来说，就是建立一个查找表。我们不是线性地增加CCR2的值，而是增加一个“视觉亮度值”，通过查表转换成对应的、非线性的CCR2值。比如，我们希望视觉亮度线性增加10档，那么这10档对应的占空比值可能分别是：0， 1， 4， 9， 16， 25， 36， 49， 64， 81， 100（百分比）。这是一个平方关系。在代码中，我们可以预先计算好这个表，PWM_IncreaseDuty函数每次增加的是亮度等级，然后通过查表获得实际的CCR2值再设置。这样，人眼看到的亮度变化就是均匀的了。

4.3 添加更丰富的交互反馈

基础功能实现后，我们可以让它更“智能”、更友好。

加入蜂鸣器提示音：每次按下按键调节亮度时，让蜂鸣器短促地“滴”一声，提供触觉之外的听觉反馈，体验会好很多。
使用OLED显示状态：加一块小OLED屏幕，实时显示当前的占空比百分比、PWM频率等信息。这对于调试和演示来说非常直观。
实现按键长按加速：这是非常实用的功能。短按按键，占空比以1%的步进变化；如果按住按键超过1秒，则进入加速模式，步进变为5%/次，方便快速调节。这需要在按键处理状态机里加入计时逻辑。
保存亮度设置：利用STM32内部的Flash（或外挂的EEPROM），在系统断电前，将当前亮度值（占空比）保存起来。下次上电时，自动恢复到上次的亮度。这会让你的作品看起来像一个真正的产品。

调试的过程，就是不断发现问题、思考解决方案、并动手实现的过程。我印象很深的是有一次做电机调速，PWM频率没选对，正好和机械结构产生了共振，那声音听得人头皮发麻。后来用示波器一点点测，调整频率才解决。所以，多动手、多观察、多思考，这些经验积累起来，以后遇到更复杂的问题你也能从容应对。好了，关于STM32标准库的PWM动态调光，咱们就先聊到这里，希望这些实实在在的步骤和经验能帮你少走些弯路。