简介面向STM32初学者的按键控制LED灯亮度工程包基于STM32F103最小系统板利用六个按键调节六档PWM占空比实现LED从微光到高亮的多级亮度切换。工程覆盖通用输入输出接口的输入输出配置、定时器PWM波形生成、外部中断触发以及按键消抖策略完整演示了从检测按键事件到更新捕获比较寄存器、改变输出信号平均电压的软硬件协同流程。压缩包共202个文件整体约6.76MB核心为C语言源码与头文件另含Keil工程配置文件、编译链接生成的目标文件与映射文件、辅助说明文档等类型覆盖源码阅读、工程构建与结果验证各环节。目前已有19477人学习下载资源内部分模块划分清晰针对按键中断与定时器输出等关键功能均有独立文件组织便于对照查阅适合正在学习STM32定时器与PWM应用的开发者作为课程设计或入门实战的参考模板。通过修改占空比参数还可扩展为呼吸灯、按键长按连续调光等进阶功能实践价值较强。 最近总有人问我STM32 怎么用按键控制 LED 灯亮度很多朋友刚入门点个 LED 没问题一说到“调节亮度”就卡住了。其实这个项目特别适合练手因为它同时牵扯到按键输入、PWM 输出、中断和定时器这些嵌入式开发的核心知识点做完这个项目你再去看舵机控制、电机调速、屏幕背光调节思路基本是通的。这篇笔记就把我从硬件电路到代码实现再到踩坑排查的完整过程写下来给正在做类似练习的同学一个参考。1. 整体设计与思路拆解1.1 为什么亮度控制必须用 PWM先把最核心的问题说透想让 LED 可调亮度为什么大家第一反应都是 PWM“亮度可调”说白了就是让 LED 上的平均电流可调。你当然可以在 LED 的回路里串一个可调电阻或者用 DAC 输出一个可变的模拟电压来控制驱动管的导通程度这种方法叫“线性调节”。但它有个很大的毛病除了让 LED 发光消耗的能量多余的功率全变成了热量白白浪费掉。尤其在电池供电的设备里这种方案基本不划算。PWM脉冲宽度调制的思路完全不一样。用一个频率固定的方波去驱动 LED通过改变方波的“占空比”来控制 LED 在一个周期内的平均导通时间。占空比越高平均电流越大LED 看起来就越亮占空比越低LED 看起来就越暗。我对新手最喜欢打的比方是PWM 调光就是你在快速开关灯。假设你一秒内开关灯一百次灯开的时间占 30%人眼看起来就是“暗一点”灯开的时间占 80%人眼看起来就是“亮一点”。因为开关频率够高人眼完全察觉不到闪烁只感觉到亮暗变化。STM32 定时器输出的 PWM 信号频率和占空比都可以通过寄存器精确控制。这个方案的优势非常明显几乎不产生额外热量效率接近 100%只需一个 GPIO 引脚而且 STM32 的定时器硬件自动产生 PWM 波形CPU 完全不用管可以在调节间隙去干别的事。这也是为什么几乎所有 LED 驱动、电机驱动方案都在用 PWM。1.2 方案选型按键扫描用轮询还是中断定了用 PWM 之后还有个关键选择按键怎么读很多入门同学的第一反应是“用外部中断”。因为听到“按键就是输入”觉得外部中断高级。在这个项目里我却更推荐用定时器轮询扫键。原因很简单这个项目只需要一个按键轮询扫描的代码逻辑非常清晰配合定时器固定周期去读一次引脚天然就带“采样”的概念。外部中断适合按键需要“立即响应”的场景比如急停按钮但从按下到识别出来单片机执行一小段代码也就是微秒级别的事人的手指头根本感觉不出差别。中断里最忌讳做耗时的操作比如延时消抖。如果你在中断里用了 delay很容易造成主循环卡死或者其它中断丢失这是新手最容易踩的坑。所以我最终选择的方案是TIM 定时器产生 PWM 信号驱动 LED再用一个定时器或者复用同一个定时器的更新中断周期性扫描按键配合软件消抖和一个简单的状态机来改变目标占空比。2. 硬件细节解析按键电路、LED 驱动与消抖2.1 STM32 按键电路怎么接才算合理按键电路看着简单但连接方式直接决定你要不要开内部上拉以及代码里怎么判断“按下”。STM32 的 GPIO 在输入模式下有三种常见接法接法电路形式按下时电平空闲时电平代码判断方式 A内部上拉GPIO 配置为上拉输入按键接 GND低电平高电平读引脚为 0 表示按下方式 B外部上拉GPIO 浮空输入 外部 10kΩ 上拉电阻按键接 GND低电平高电平读引脚为 0 表示按下方式 C外部下拉GPIO 浮空输入 外部 10kΩ 下拉电阻按键接 VCC高电平低电平读引脚为 1 表示按下我最推荐方式 A电路最干净只用一个按键两条线内部上拉是 STM32 硬件自带的能力完全够用。接线时按键一端接 GND另一端接 PA0 之类的 GPIO 引脚。这里有一个非常容易被忽略的点不要用“外部上拉 3.3V 直接进 GPIO”以外的做法去省电阻。有些同学图省事按键一端接 3.3V一端接 GPIO也不开内部上拉结果就是引脚悬空电平随机跳变按键按下没反应松手反而触发了。这种“引脚浮空”的错误在初学者里出现率极高。2.2 LED 驱动电路能不能直接把灯接在 IO 上很多人直接拿一个 LED 串上一个电阻接到 STM32 的引脚上这是没问题的但前提是电流不能超限。以 STM32F103 为例GPIO 的灌电流和拉电流能力大概在 ±25mA 左右实际上我们通常把工作电流控制在 10mA-20mA 以内避免长期满负荷运行导致芯片发热或者引脚老化。单个 LED 正常工作电流在 5-20mA 之间所以一个 LED 直连引脚是可行的。电阻值怎么选LED 红色普通指示灯的压降大约 1.8V-2.0VSTM32 GPIO 输出高电平大约 3.3V如果目标电流是 10mA那么串联电阻就是R (3.3V - 2.0V) / 0.01A 130Ω取整后选 100Ω 或 220Ω 都能接受。220Ω 时电流大约 6mA亮度偏暗一些但也足够用100Ω 时电流约 13mA更亮一点。我自己习惯用 220Ω省电而且足够肉眼观察。如果你以后要用大功率 LED 或者 LED 灯带那就不建议直接接在 GPIO 上了得用三极管或 MOS 管做驱动开关这时候专门的高效 LED 驱动芯片或者专用的恒流驱动芯片会是更好的选择但那是另一个话题了。2.3 按键消抖到底在消什么说到按键就绕不开“消抖”。很多人刚开始不理解一个机械开关怎么会有抖动手指按下去的那一下金属簧片不是一秒钟之内就稳定闭合的而是在闭合和断开之间来回弹跳几次整个过程可能持续 5-20ms。如果不做处理单片机会以为你按了好几次键——本来想调节一档亮度结果直接跳了好几档。消抖有两种思路硬件消抖在按键两端并联一个 0.1uF 的电容利用电容两端电压不能突变的特性把抖动滤掉。好处是 CPU 代码简单坏处是增加元件成本而且电容选大了会影响按键的响应速度。软件消抖目前最通用的做法是“延时消抖”初次检测到按键引脚电平变化后延时 10-20ms再次读取确认。更高级的做法是状态机扫描每 5ms 或者 10ms 扫描一次按键只有连续两次以上电平才认为有效。这也是我实际项目里最推荐的在主循环或定时器中断里按固定周期去采样既不阻塞 CPU又能保证消抖效果。3. 实操过程与核心环节实现3.1 用 STM32CubeMX 快速搭建工程现在做 STM32 开发基本都离不开 STM32CubeMX。这里我以最常见的 STM32F103C8T6 核心板为例把配置步骤列出来每一步都说清楚为什么。时钟配置F103 最高主频 72MHz一般直接在 Clock Configuration 里把 HSE 选为 Crystal/Ceramic Resonator然后把 HCLK 设为 72MHz软件会自动分配好 PLL 参数。定时器配置我们需要一路 PWM 输出。TIM2、TIM3、TIM4 都可以。我选 TIM3配置 Channel 1 为 PWM Generation CH1输出引脚通常是 PA6。如果你的板子上 PA6 刚好连着其它外设也可以换 CH2引脚作相应调整。PWM 频率我设置在 1kHz也就是 Period 设置为 999Prescaler 设置为 71这样 72MHz / 72 / 1000 1kHz占空比的最小调节精度是 0.1%。按键引脚配置按键接 PA0GPIO 模式选 Input mode with Pull-up/Pull-down然后在上拉下拉选择里勾选 Pull-up。这样按键就是高电平空闲按下变低。生成代码的时候我习惯勾选 “Generate peripheral initialization as a pair of .c/.h files per peripheral”这样每个外设的初始化代码独立成文件看起来清爽后期维护也方便。3.2 核心逻辑代码状态机 占空比调节工程生成之后就要写主逻辑了。我的思路是这样的用全局变量 g_target_duty 记录当前目标占空比初始值是 20。每次检测到按键短按就把目标占空比加 10达到 100 后回到 0。检测按键安排在 TIM 更新中断里做每 10ms 进入一次扫描 PA0 电平并做软件消抖。主循环里只需要做一件事调用 __HAL_TIM_SET_COMPARE 把目标占空比写入定时器比较寄存器LED 亮度立刻改变。核心代码长这样/* main.h 或者 main.c 里定义 */ #define LED_PWM_TIM htim3 #define LED_PWM_CH TIM_CHANNEL_1 #define KEY_GPIO_PORT GPIOA #define KEY_PIN GPIO_PIN_0 uint8_t g_target_duty 20; /* 目标占空比单位 % */ uint8_t g_key_state 0; /* 当前按键状态1 表示按下且已确认 */ uint8_t g_key_prev 0; /* 上一次采样电平用于消抖判断 */ uint8_t g_key_debounce_cnt 0; /* 在定时器更新中断回调里调用 */ void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim htim3) /* 这里用的是同一个定时器复用做按键扫描 */ { KeyScan_10ms(); } } void KeyScan_10ms(void) { uint8_t level HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_PIN); /* 软件消抖确认翻转后需要连续 2 次采样有效 */ if (level ! g_key_prev) { g_key_debounce_cnt; if (g_key_debounce_cnt 2) { g_key_debounce_cnt 0; g_key_prev level; if (level 0) /* 确认按下 */ { g_key_state 1; /* 置按键事件标志 */ } } } else { g_key_debounce_cnt 0; } } int main(void) { /* ... 初始化代码由 CubeMX 生成 ... */ HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); /* 启动 PWM 输出 */ __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 200); /* 初次设为 20% 占空比 */ while (1) { if (g_key_state) { g_key_state 0; /* 调节目标占空比 */ g_target_duty 10; if (g_target_duty 100) { g_target_duty 0; } /* 写入比较寄存器 */ uint32_t compare (uint32_t)g_target_duty * (TIM3-ARR 1) / 100; __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, compare); /* 用串口或者调试器观察当前值便于调试 */ printf(Duty: %d%%\r\n, g_target_duty); } } }这里有一个重点要说计算比较寄存器值。很多人直接把占空比数字当比较值用结果 LED 亮度要么永远不亮要么永远全亮。原因很简单——比较值和占空比不是一回事。如果你的定时器 ARR 是 999那么 50% 占空比对应比较值应该是 499 或 500而不是 50。我用compare g_target_duty * (ARR 1) / 100这一步就是把百分数映射成定时器的实际比较值这样占空比变量可以一直用 0-100 的整数来表示逻辑更清晰。3.3 我踩过的坑引脚重映射和 PWM 频率选择第一次做这个项目的时候我在 TIM3 的 PWM 引脚上栽了跟头。F103 上 TIM3_CH1 默认映射在 PA6但如果你在 CubeMX 里不小心勾了 Remap引脚就变成了 PB4。板子上 PA6 和 PB4 旁边都有焊盘插线的时候很容易插错结果 LED 怎么都不亮。解决的办法很简单回到 CubeMX 的 Pinout 视图波形图标上点击一下看它提示的实际引脚号对照原理图确认最终位置。这是我在新手时期养成的最重要的习惯之一。PWM 频率的选择也有讲究。人眼对 100Hz 以下的光源闪烁比较敏感所以 PWM 频率至少要选 500Hz 以上1kHz 是很稳妥的选择。如果结构上有振动比如电机带动 LED频率太低会出现“频闪”现象看起来 LED 没抖动但拍照或高速运动时能看到明显的条纹。现在很多 LED 驱动做到 20kHz 以上一是避开人耳听觉范围二是让手机摄像头也拍不出条纹不过 1kHz 对我们这个项目足够用了。4. 常见问题与排查技巧实录做这个项目每个人几乎都会遇到下面几个问题我按出现频率从高到低排个序把排查思路写出来。现象可能原因排查方法按键按下去没反应GPIO 模式配错浮空输入、引脚搞错、按键另一端没接 GND用万用表量按键引脚对地电压按下时应变低LED 永远不亮PWM 没启动、比较值一直是 0、引脚复用配置错先查 GPIO 电平用示波器看 PWM 波形亮度只能跳两档按键消抖没做好连续触发缩短消抖时间检查按键采样逻辑输出占空比正确但亮度不对LED 接错限流电阻、电流方向反了确认 LED 正负极确认电阻阻值编译下载时报错调试器连接问题检查 ST-Link 接线和驱动4.1 按键按下去没反应最先查什么八成是硬件接线问题。我之前见过一个同学把按键接在 GND 和 PB1 上代码里却是读 PA0查了半小时才发现。所以我的习惯是先量引脚空闲电平和按下电平确认引脚编号和代码一致再看软件逻辑。还有个常见问题用 CubeMX 配置时按键引脚没有勾选 Pull-up 上拉。此时引脚悬空STM32 内部既没有上拉也没有下拉读到的电平完全不确定。这样按键按下去可能偶尔有反应松手之后也可能误触发。排查方式是按下前先打印引脚电平看是不是稳定在高电平。4.2 LED 亮度调节不线性中间档位跳变明显如果你把占空比从 10 调到 20肉眼几乎看不出变化但从 80 调到 90变化却很明显这是因为人眼的亮度感知不是线性的而是近似对数的关系。也就是说占空比从 20% 变到 40%看起来像是在“变亮初期”而 80% 到 90% 的变化就很刺激。实际操作中如果你发现档位之间跳跃太明显可以考虑做一个非线性映射表让低亮度区间的调节步长小一些。但说实话业余项目用线性调节也完全能用只是“体验细节”有差别。这里也引出一个思考为什么那么多灯具控制器都支持“无极调光”本质上就是调整 PWM 占空比的映射曲线让人眼觉得亮度的变化是均匀的。4.3 编译下载报错error: no stm32 target found这个错误我刚开始玩 ST-Link 的时候经常遇到问题基本都出在调试器连接上。检查步骤我总结了四步看 ST-Link 的 SWDIO、SWCLK、GND、3.3V 四个引脚有没有接对SWDIO 和 SWCLK 交叉接错的概率特别高确认板子供电是否正常很多 ST-Link 和板子共用一个 USB 供电如果 USB 口供电不足或者接触不良就找不到 target在 Keil 或 STM32CubeProgrammer 里把调试接口选成 SW 模式不要选 JTAG如果还是不行按住板子上的复位键不放点击下载等进度条出现后再松开复位这个方法能救回很多“锁死”的芯片。4.4 PWM 波形输出异常有示波器的话这个问题特别好排查。没有示波器就把 LED 串一个低阻值电阻用万用表的交流电压档去测一端如果电压波动明显不正常那大概率是——定时器没启动。很多人初始化完之后忘了调用HAL_TIM_PWM_StartGPIO 电平是有的但就是没有方波LED 一直不亮。GPIO 复用没配置。CubeMX 里生成了代码但你在手写工程里忘了把 GPIO 配置成复用推挽模式。重映射搞错。F103 系列 TIM 引脚有重映射功能配置不对会输出到错误引脚上。5. 从按键调光到更多有趣玩法5.1 改成呼吸灯按键控制亮度做熟之后把项目扩展成呼吸灯特别有意思。逻辑非常简单主循环里用一个变量让占空比从 0 缓慢加到 100再从 100 减到 0周而复始。每次调节的时候不要太快建议每 5ms 改变 1-2 个百分点的占空比这样视觉上才像呼吸。int dir 1; uint16_t duty 0; while (1) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, duty * 10); HAL_Delay(5); duty dir; if (duty 100) dir -1; if (duty 0) dir 1; }这段代码我在开发板上实测下来效果很自然不会感觉到跳变推荐有兴趣的同学试试。5.2 长短按和档位记忆按键连续循环调光最大的问题是从最暗调回最亮中间要按十几次。一个更实用的做法是支持长按连续调节按下超过 500ms 后每隔 100ms 自动加一档松手就停在当前档位。实现起来也不复杂扫描按键时记录按下时间戳在主循环中判断如果当前处于“按下状态”且时间差超过阈值就自动执行一次档位递增。这样从最暗调到最亮只需要按住两三秒体验好很多。档位记忆也不难利用 STM32 内部 Flash 的一个扇区每次档位改变后把值写进去下次上电直接读出来初始化。不过写 Flash 要注意擦写寿命频繁写入会磨损 Flash实际产品里通常把“最后保存的档位”延迟 5 秒再写入避免每次微调都触发擦写。5.3 使用中断读取按键的注意事项如果你确实要用外部中断我建议的方式是中断服务函数里只设置标志位不做消抖延时也不改变 PWM 占空比退出中断后在主循环里检测到标志位再执行 10ms 的软件消抖和后续逻辑。这样既保证了按键响应的及时性又不会阻塞主循环。我自己测试过用外部中断做按键调节亮度体验上和轮询扫描几乎没有差别。这个方案在低功耗设备里会更重要因为主循环可能大部分时间都处于休眠状态依靠中断唤醒。最后这个项目做完之后我最大的感受是嵌入式入门不要追求“高大上”把按键、PWM、定时器这几块基本功吃透后面很多项目都是这几个知识点换着花样组合。控制 LED 亮度只是 PWM 的一个应用同样的思路放到直流电机调速、舵机角度控制、逆变器输出上只是驱动电路和参数不一样核心逻辑完全通用。如果条件允许建议你买一个逻辑分析仪或者二手示波器把按键按下瞬间的波形抓出来看看亲眼看一下“抖动”是什么样子观察 PWM 占空比变化时波形宽度的变化这个体验比看十篇文章都有用。调好看一眼波形你心里就特别有底了。本文还有配套的精品资源点击获取 STM32按键控制LED亮度：PWM调光原理与代码实现
简介面向STM32初学者的按键控制LED灯亮度工程包基于STM32F103最小系统板利用六个按键调节六档PWM占空比实现LED从微光到高亮的多级亮度切换。工程覆盖通用输入输出接口的输入输出配置、定时器PWM波形生成、外部中断触发以及按键消抖策略完整演示了从检测按键事件到更新捕获比较寄存器、改变输出信号平均电压的软硬件协同流程。压缩包共202个文件整体约6.76MB核心为C语言源码与头文件另含Keil工程配置文件、编译链接生成的目标文件与映射文件、辅助说明文档等类型覆盖源码阅读、工程构建与结果验证各环节。目前已有19477人学习下载资源内部分模块划分清晰针对按键中断与定时器输出等关键功能均有独立文件组织便于对照查阅适合正在学习STM32定时器与PWM应用的开发者作为课程设计或入门实战的参考模板。通过修改占空比参数还可扩展为呼吸灯、按键长按连续调光等进阶功能实践价值较强。 最近总有人问我STM32 怎么用按键控制 LED 灯亮度很多朋友刚入门点个 LED 没问题一说到“调节亮度”就卡住了。其实这个项目特别适合练手因为它同时牵扯到按键输入、PWM 输出、中断和定时器这些嵌入式开发的核心知识点做完这个项目你再去看舵机控制、电机调速、屏幕背光调节思路基本是通的。这篇笔记就把我从硬件电路到代码实现再到踩坑排查的完整过程写下来给正在做类似练习的同学一个参考。1. 整体设计与思路拆解1.1 为什么亮度控制必须用 PWM先把最核心的问题说透想让 LED 可调亮度为什么大家第一反应都是 PWM“亮度可调”说白了就是让 LED 上的平均电流可调。你当然可以在 LED 的回路里串一个可调电阻或者用 DAC 输出一个可变的模拟电压来控制驱动管的导通程度这种方法叫“线性调节”。但它有个很大的毛病除了让 LED 发光消耗的能量多余的功率全变成了热量白白浪费掉。尤其在电池供电的设备里这种方案基本不划算。PWM脉冲宽度调制的思路完全不一样。用一个频率固定的方波去驱动 LED通过改变方波的“占空比”来控制 LED 在一个周期内的平均导通时间。占空比越高平均电流越大LED 看起来就越亮占空比越低LED 看起来就越暗。我对新手最喜欢打的比方是PWM 调光就是你在快速开关灯。假设你一秒内开关灯一百次灯开的时间占 30%人眼看起来就是“暗一点”灯开的时间占 80%人眼看起来就是“亮一点”。因为开关频率够高人眼完全察觉不到闪烁只感觉到亮暗变化。STM32 定时器输出的 PWM 信号频率和占空比都可以通过寄存器精确控制。这个方案的优势非常明显几乎不产生额外热量效率接近 100%只需一个 GPIO 引脚而且 STM32 的定时器硬件自动产生 PWM 波形CPU 完全不用管可以在调节间隙去干别的事。这也是为什么几乎所有 LED 驱动、电机驱动方案都在用 PWM。1.2 方案选型按键扫描用轮询还是中断定了用 PWM 之后还有个关键选择按键怎么读很多入门同学的第一反应是“用外部中断”。因为听到“按键就是输入”觉得外部中断高级。在这个项目里我却更推荐用定时器轮询扫键。原因很简单这个项目只需要一个按键轮询扫描的代码逻辑非常清晰配合定时器固定周期去读一次引脚天然就带“采样”的概念。外部中断适合按键需要“立即响应”的场景比如急停按钮但从按下到识别出来单片机执行一小段代码也就是微秒级别的事人的手指头根本感觉不出差别。中断里最忌讳做耗时的操作比如延时消抖。如果你在中断里用了 delay很容易造成主循环卡死或者其它中断丢失这是新手最容易踩的坑。所以我最终选择的方案是TIM 定时器产生 PWM 信号驱动 LED再用一个定时器或者复用同一个定时器的更新中断周期性扫描按键配合软件消抖和一个简单的状态机来改变目标占空比。2. 硬件细节解析按键电路、LED 驱动与消抖2.1 STM32 按键电路怎么接才算合理按键电路看着简单但连接方式直接决定你要不要开内部上拉以及代码里怎么判断“按下”。STM32 的 GPIO 在输入模式下有三种常见接法接法电路形式按下时电平空闲时电平代码判断方式 A内部上拉GPIO 配置为上拉输入按键接 GND低电平高电平读引脚为 0 表示按下方式 B外部上拉GPIO 浮空输入 外部 10kΩ 上拉电阻按键接 GND低电平高电平读引脚为 0 表示按下方式 C外部下拉GPIO 浮空输入 外部 10kΩ 下拉电阻按键接 VCC高电平低电平读引脚为 1 表示按下我最推荐方式 A电路最干净只用一个按键两条线内部上拉是 STM32 硬件自带的能力完全够用。接线时按键一端接 GND另一端接 PA0 之类的 GPIO 引脚。这里有一个非常容易被忽略的点不要用“外部上拉 3.3V 直接进 GPIO”以外的做法去省电阻。有些同学图省事按键一端接 3.3V一端接 GPIO也不开内部上拉结果就是引脚悬空电平随机跳变按键按下没反应松手反而触发了。这种“引脚浮空”的错误在初学者里出现率极高。2.2 LED 驱动电路能不能直接把灯接在 IO 上很多人直接拿一个 LED 串上一个电阻接到 STM32 的引脚上这是没问题的但前提是电流不能超限。以 STM32F103 为例GPIO 的灌电流和拉电流能力大概在 ±25mA 左右实际上我们通常把工作电流控制在 10mA-20mA 以内避免长期满负荷运行导致芯片发热或者引脚老化。单个 LED 正常工作电流在 5-20mA 之间所以一个 LED 直连引脚是可行的。电阻值怎么选LED 红色普通指示灯的压降大约 1.8V-2.0VSTM32 GPIO 输出高电平大约 3.3V如果目标电流是 10mA那么串联电阻就是R (3.3V - 2.0V) / 0.01A 130Ω取整后选 100Ω 或 220Ω 都能接受。220Ω 时电流大约 6mA亮度偏暗一些但也足够用100Ω 时电流约 13mA更亮一点。我自己习惯用 220Ω省电而且足够肉眼观察。如果你以后要用大功率 LED 或者 LED 灯带那就不建议直接接在 GPIO 上了得用三极管或 MOS 管做驱动开关这时候专门的高效 LED 驱动芯片或者专用的恒流驱动芯片会是更好的选择但那是另一个话题了。2.3 按键消抖到底在消什么说到按键就绕不开“消抖”。很多人刚开始不理解一个机械开关怎么会有抖动手指按下去的那一下金属簧片不是一秒钟之内就稳定闭合的而是在闭合和断开之间来回弹跳几次整个过程可能持续 5-20ms。如果不做处理单片机会以为你按了好几次键——本来想调节一档亮度结果直接跳了好几档。消抖有两种思路硬件消抖在按键两端并联一个 0.1uF 的电容利用电容两端电压不能突变的特性把抖动滤掉。好处是 CPU 代码简单坏处是增加元件成本而且电容选大了会影响按键的响应速度。软件消抖目前最通用的做法是“延时消抖”初次检测到按键引脚电平变化后延时 10-20ms再次读取确认。更高级的做法是状态机扫描每 5ms 或者 10ms 扫描一次按键只有连续两次以上电平才认为有效。这也是我实际项目里最推荐的在主循环或定时器中断里按固定周期去采样既不阻塞 CPU又能保证消抖效果。3. 实操过程与核心环节实现3.1 用 STM32CubeMX 快速搭建工程现在做 STM32 开发基本都离不开 STM32CubeMX。这里我以最常见的 STM32F103C8T6 核心板为例把配置步骤列出来每一步都说清楚为什么。时钟配置F103 最高主频 72MHz一般直接在 Clock Configuration 里把 HSE 选为 Crystal/Ceramic Resonator然后把 HCLK 设为 72MHz软件会自动分配好 PLL 参数。定时器配置我们需要一路 PWM 输出。TIM2、TIM3、TIM4 都可以。我选 TIM3配置 Channel 1 为 PWM Generation CH1输出引脚通常是 PA6。如果你的板子上 PA6 刚好连着其它外设也可以换 CH2引脚作相应调整。PWM 频率我设置在 1kHz也就是 Period 设置为 999Prescaler 设置为 71这样 72MHz / 72 / 1000 1kHz占空比的最小调节精度是 0.1%。按键引脚配置按键接 PA0GPIO 模式选 Input mode with Pull-up/Pull-down然后在上拉下拉选择里勾选 Pull-up。这样按键就是高电平空闲按下变低。生成代码的时候我习惯勾选 “Generate peripheral initialization as a pair of .c/.h files per peripheral”这样每个外设的初始化代码独立成文件看起来清爽后期维护也方便。3.2 核心逻辑代码状态机 占空比调节工程生成之后就要写主逻辑了。我的思路是这样的用全局变量 g_target_duty 记录当前目标占空比初始值是 20。每次检测到按键短按就把目标占空比加 10达到 100 后回到 0。检测按键安排在 TIM 更新中断里做每 10ms 进入一次扫描 PA0 电平并做软件消抖。主循环里只需要做一件事调用 __HAL_TIM_SET_COMPARE 把目标占空比写入定时器比较寄存器LED 亮度立刻改变。核心代码长这样/* main.h 或者 main.c 里定义 */ #define LED_PWM_TIM htim3 #define LED_PWM_CH TIM_CHANNEL_1 #define KEY_GPIO_PORT GPIOA #define KEY_PIN GPIO_PIN_0 uint8_t g_target_duty 20; /* 目标占空比单位 % */ uint8_t g_key_state 0; /* 当前按键状态1 表示按下且已确认 */ uint8_t g_key_prev 0; /* 上一次采样电平用于消抖判断 */ uint8_t g_key_debounce_cnt 0; /* 在定时器更新中断回调里调用 */ void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim htim3) /* 这里用的是同一个定时器复用做按键扫描 */ { KeyScan_10ms(); } } void KeyScan_10ms(void) { uint8_t level HAL_GPIO_ReadPin(KEY_GPIO_PORT, KEY_PIN); /* 软件消抖确认翻转后需要连续 2 次采样有效 */ if (level ! g_key_prev) { g_key_debounce_cnt; if (g_key_debounce_cnt 2) { g_key_debounce_cnt 0; g_key_prev level; if (level 0) /* 确认按下 */ { g_key_state 1; /* 置按键事件标志 */ } } } else { g_key_debounce_cnt 0; } } int main(void) { /* ... 初始化代码由 CubeMX 生成 ... */ HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); /* 启动 PWM 输出 */ __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, 200); /* 初次设为 20% 占空比 */ while (1) { if (g_key_state) { g_key_state 0; /* 调节目标占空比 */ g_target_duty 10; if (g_target_duty 100) { g_target_duty 0; } /* 写入比较寄存器 */ uint32_t compare (uint32_t)g_target_duty * (TIM3-ARR 1) / 100; __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, compare); /* 用串口或者调试器观察当前值便于调试 */ printf(Duty: %d%%\r\n, g_target_duty); } } }这里有一个重点要说计算比较寄存器值。很多人直接把占空比数字当比较值用结果 LED 亮度要么永远不亮要么永远全亮。原因很简单——比较值和占空比不是一回事。如果你的定时器 ARR 是 999那么 50% 占空比对应比较值应该是 499 或 500而不是 50。我用compare g_target_duty * (ARR 1) / 100这一步就是把百分数映射成定时器的实际比较值这样占空比变量可以一直用 0-100 的整数来表示逻辑更清晰。3.3 我踩过的坑引脚重映射和 PWM 频率选择第一次做这个项目的时候我在 TIM3 的 PWM 引脚上栽了跟头。F103 上 TIM3_CH1 默认映射在 PA6但如果你在 CubeMX 里不小心勾了 Remap引脚就变成了 PB4。板子上 PA6 和 PB4 旁边都有焊盘插线的时候很容易插错结果 LED 怎么都不亮。解决的办法很简单回到 CubeMX 的 Pinout 视图波形图标上点击一下看它提示的实际引脚号对照原理图确认最终位置。这是我在新手时期养成的最重要的习惯之一。PWM 频率的选择也有讲究。人眼对 100Hz 以下的光源闪烁比较敏感所以 PWM 频率至少要选 500Hz 以上1kHz 是很稳妥的选择。如果结构上有振动比如电机带动 LED频率太低会出现“频闪”现象看起来 LED 没抖动但拍照或高速运动时能看到明显的条纹。现在很多 LED 驱动做到 20kHz 以上一是避开人耳听觉范围二是让手机摄像头也拍不出条纹不过 1kHz 对我们这个项目足够用了。4. 常见问题与排查技巧实录做这个项目每个人几乎都会遇到下面几个问题我按出现频率从高到低排个序把排查思路写出来。现象可能原因排查方法按键按下去没反应GPIO 模式配错浮空输入、引脚搞错、按键另一端没接 GND用万用表量按键引脚对地电压按下时应变低LED 永远不亮PWM 没启动、比较值一直是 0、引脚复用配置错先查 GPIO 电平用示波器看 PWM 波形亮度只能跳两档按键消抖没做好连续触发缩短消抖时间检查按键采样逻辑输出占空比正确但亮度不对LED 接错限流电阻、电流方向反了确认 LED 正负极确认电阻阻值编译下载时报错调试器连接问题检查 ST-Link 接线和驱动4.1 按键按下去没反应最先查什么八成是硬件接线问题。我之前见过一个同学把按键接在 GND 和 PB1 上代码里却是读 PA0查了半小时才发现。所以我的习惯是先量引脚空闲电平和按下电平确认引脚编号和代码一致再看软件逻辑。还有个常见问题用 CubeMX 配置时按键引脚没有勾选 Pull-up 上拉。此时引脚悬空STM32 内部既没有上拉也没有下拉读到的电平完全不确定。这样按键按下去可能偶尔有反应松手之后也可能误触发。排查方式是按下前先打印引脚电平看是不是稳定在高电平。4.2 LED 亮度调节不线性中间档位跳变明显如果你把占空比从 10 调到 20肉眼几乎看不出变化但从 80 调到 90变化却很明显这是因为人眼的亮度感知不是线性的而是近似对数的关系。也就是说占空比从 20% 变到 40%看起来像是在“变亮初期”而 80% 到 90% 的变化就很刺激。实际操作中如果你发现档位之间跳跃太明显可以考虑做一个非线性映射表让低亮度区间的调节步长小一些。但说实话业余项目用线性调节也完全能用只是“体验细节”有差别。这里也引出一个思考为什么那么多灯具控制器都支持“无极调光”本质上就是调整 PWM 占空比的映射曲线让人眼觉得亮度的变化是均匀的。4.3 编译下载报错error: no stm32 target found这个错误我刚开始玩 ST-Link 的时候经常遇到问题基本都出在调试器连接上。检查步骤我总结了四步看 ST-Link 的 SWDIO、SWCLK、GND、3.3V 四个引脚有没有接对SWDIO 和 SWCLK 交叉接错的概率特别高确认板子供电是否正常很多 ST-Link 和板子共用一个 USB 供电如果 USB 口供电不足或者接触不良就找不到 target在 Keil 或 STM32CubeProgrammer 里把调试接口选成 SW 模式不要选 JTAG如果还是不行按住板子上的复位键不放点击下载等进度条出现后再松开复位这个方法能救回很多“锁死”的芯片。4.4 PWM 波形输出异常有示波器的话这个问题特别好排查。没有示波器就把 LED 串一个低阻值电阻用万用表的交流电压档去测一端如果电压波动明显不正常那大概率是——定时器没启动。很多人初始化完之后忘了调用HAL_TIM_PWM_StartGPIO 电平是有的但就是没有方波LED 一直不亮。GPIO 复用没配置。CubeMX 里生成了代码但你在手写工程里忘了把 GPIO 配置成复用推挽模式。重映射搞错。F103 系列 TIM 引脚有重映射功能配置不对会输出到错误引脚上。5. 从按键调光到更多有趣玩法5.1 改成呼吸灯按键控制亮度做熟之后把项目扩展成呼吸灯特别有意思。逻辑非常简单主循环里用一个变量让占空比从 0 缓慢加到 100再从 100 减到 0周而复始。每次调节的时候不要太快建议每 5ms 改变 1-2 个百分点的占空比这样视觉上才像呼吸。int dir 1; uint16_t duty 0; while (1) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, duty * 10); HAL_Delay(5); duty dir; if (duty 100) dir -1; if (duty 0) dir 1; }这段代码我在开发板上实测下来效果很自然不会感觉到跳变推荐有兴趣的同学试试。5.2 长短按和档位记忆按键连续循环调光最大的问题是从最暗调回最亮中间要按十几次。一个更实用的做法是支持长按连续调节按下超过 500ms 后每隔 100ms 自动加一档松手就停在当前档位。实现起来也不复杂扫描按键时记录按下时间戳在主循环中判断如果当前处于“按下状态”且时间差超过阈值就自动执行一次档位递增。这样从最暗调到最亮只需要按住两三秒体验好很多。档位记忆也不难利用 STM32 内部 Flash 的一个扇区每次档位改变后把值写进去下次上电直接读出来初始化。不过写 Flash 要注意擦写寿命频繁写入会磨损 Flash实际产品里通常把“最后保存的档位”延迟 5 秒再写入避免每次微调都触发擦写。5.3 使用中断读取按键的注意事项如果你确实要用外部中断我建议的方式是中断服务函数里只设置标志位不做消抖延时也不改变 PWM 占空比退出中断后在主循环里检测到标志位再执行 10ms 的软件消抖和后续逻辑。这样既保证了按键响应的及时性又不会阻塞主循环。我自己测试过用外部中断做按键调节亮度体验上和轮询扫描几乎没有差别。这个方案在低功耗设备里会更重要因为主循环可能大部分时间都处于休眠状态依靠中断唤醒。最后这个项目做完之后我最大的感受是嵌入式入门不要追求“高大上”把按键、PWM、定时器这几块基本功吃透后面很多项目都是这几个知识点换着花样组合。控制 LED 亮度只是 PWM 的一个应用同样的思路放到直流电机调速、舵机角度控制、逆变器输出上只是驱动电路和参数不一样核心逻辑完全通用。如果条件允许建议你买一个逻辑分析仪或者二手示波器把按键按下瞬间的波形抓出来看看亲眼看一下“抖动”是什么样子观察 PWM 占空比变化时波形宽度的变化这个体验比看十篇文章都有用。调好看一眼波形你心里就特别有底了。本文还有配套的精品资源点击获取